xref: /freebsd/usr.sbin/nvram/nvram.8 (revision a90b9d0159070121c221b966469c3e36d912bf82)
1.\"-
2.\" Copyright (c) 2006 Maxim Sobolev <sobomax@FreeBSD.org>
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\"
14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
16.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
17.\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
18.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
19.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
20.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
22.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
23.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
24.\" POSSIBILITY OF SUCH DAMAGE.
25.\"
26.Dd June 19, 2020
27.Dt NVRAM 8 powerpc
28.Os
29.Sh NAME
30.Nm nvram
31.Nd "display or modify contents of the EEPROM or NVRAM"
32.Sh SYNOPSIS
33.Nm
34.Fl p
35.Nm
36.Oo Fl d Ar name Oc Ar ...
37.Op Ar name Ns = Ns Ar value ...
38.Sh DESCRIPTION
39The
40.Nm
41utility provides an interface for displaying and changing the system's
42configuration variables contained in EEPROM or NVRAM.
43In the first synopsis form, all available configuration variables and their
44current values are printed.
45In the second form, the variable selected by
46.Ar name
47is either removed or its value is changed to the
48.Ar value
49following by
50.Ql =
51sign.
52.Pp
53The following options are available:
54.Bl -tag -width indent
55.It Fl d Ar name
56Delete the variable selected by
57.Ar name
58from the EEPROM or NVRAM.
59The
60.Fl d
61flag can be specified multiple times, in which case multiple variables
62will be removed.
63.It Fl p
64Print all available configuration variables and their current values.
65.El
66.Sh EXAMPLES
67Print all available configuration variables and their current values:
68.Pp
69.Dl "nvram -p"
70.Pp
71Remove the variable named
72.Va local-mac-address? :
73.Pp
74.Dl "nvram -d local-mac-address\e?"
75.Pp
76Set the value of the
77.Va local-mac-address?
78variable to
79.Dq Li true :
80.Pp
81.Dl "nvram local-mac-address\e?=true"
82.Pp
83Note that the
84.Ql \e
85in the above examples is used to keep the shell from interpreting the
86.Ql \&? .
87.Pp
88Remove variables named
89.Va foo
90and
91.Va bar
92and set variable named
93.Va baz
94to
95.Dq Li 100 :
96.Pp
97.Dl "nvram -d foo -d bar baz=100"
98.Sh SEE ALSO
99.Xr powermac_nvram 4
100.Sh HISTORY
101The
102.Nm
103utility first appeared in
104.Fx 7.0 .
105It is inspired by the
106Darwin/Mac OS X
107.Nm
108utility.
109.Sh AUTHORS
110.An Maxim Sobolev Aq Mt sobomax@FreeBSD.org
111