aboutsummaryrefslogtreecommitdiffstats
path: root/system_cmds/nvram.tproj/nvram.8
diff options
context:
space:
mode:
Diffstat (limited to 'system_cmds/nvram.tproj/nvram.8')
-rw-r--r--system_cmds/nvram.tproj/nvram.893
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