diff options
Diffstat (limited to 'system_cmds/nvram.tproj/nvram.8')
-rw-r--r-- | system_cmds/nvram.tproj/nvram.8 | 93 |
1 files changed, 93 insertions, 0 deletions
diff --git a/system_cmds/nvram.tproj/nvram.8 b/system_cmds/nvram.tproj/nvram.8 new file mode 100644 index 0000000..74f7b38 --- /dev/null +++ b/system_cmds/nvram.tproj/nvram.8 @@ -0,0 +1,93 @@ +.\" +.\" Copyright (c) 2000-2003 Apple Computer, Inc. All rights reserved. +.\" +.TH nvram 8 "October 28, 2003" +.SH NAME +nvram \- manipulate firmware NVRAM variables +.SH SYNOPSIS +.B nvram +[ +.B -p +] [ +.B -f +.IR filename +] [ +.B -d +.IR name +] [ +.B -c +] [ +.IR name +[= +.IR value +]] ... +.SH DESCRIPTION +The +.I nvram +command allows manipulation of firmware NVRAM variables. It +can be used to get or set a variable. It can also be used to print +all of the variables or set a list of variables from a file. +Changes to NVRAM variables are only saved by clean restart or shutdown. +.LP +In principle, +.IR name +can be any string. In practice, not all strings will be accepted. +New World machines can create new variables as desired. Some variables +require administrator privilege to get or set. +.LP +The given +.IR value +must match the data type required for +.IR name . +Binary data can be set using the %xx notation, where xx is the hex +value of the byte. The type for new variables is always binary +data. +.SH OPTIONS +.\" ========== +.TP +.BI \-d " name" +Deletes the named firmware variable. +.\" ========== +.TP +.BI \-f " filename" +Set firmware variables from a text file. The file must be a +list of "name value" statements. The first space on each line +is taken to be the separator between "name" and "value". If +the last character of a line is \\, the value extends to the next line. +.\" ========== +.TP +.B \-x +Use XML format for reading and writing variables. +This option must be used before the +.B \-p +or +.B \-f +options, since arguments are processed in order. +.TP +.B \-c +Delete all of the firmware variables. +.TP +.B \-p +Print all of the firmware variables. +.SH EXAMPLES +.LP +.RS +example% nvram boot-args="-s rd=*hd:10" +.RE +.LP +Set the boot-args variable to "-s rd=*hd:10". This would specify +single user mode with the root device in hard drive partition 10. +.LP +.RS +example% nvram my-variable="String One%00String Two%00%00" +.RE +.LP +Create a new variable, my-variable, containing a list of two +C-strings that is terminated by a NUL. +.LP +.RS +example% nvram -d my-variable +.RE +.LP +Deletes the variable named my-variable. +.PD |