diff options
author | sobomax <sobomax@FreeBSD.org> | 2006-08-01 22:19:01 +0000 |
---|---|---|
committer | sobomax <sobomax@FreeBSD.org> | 2006-08-01 22:19:01 +0000 |
commit | a2e1257dac349364bf2162e7c5d187107fcd8725 (patch) | |
tree | aba24c38e600543d1256c6e33ef0efd99bf3900f /usr.sbin | |
parent | a152234cf9a52766984ecb9a96cc1e5740ae9d78 (diff) | |
download | FreeBSD-src-a2e1257dac349364bf2162e7c5d187107fcd8725.zip FreeBSD-src-a2e1257dac349364bf2162e7c5d187107fcd8725.tar.gz |
Add device to access and modify Open Firmware NVRAM settings in
PowerPC-based Apple's machines and small utility to do it from
userland modelled after the similar utility in Darwin/OSX.
Only tested on 1.25GHz G4 Mac Mini.
MFC after: 1 month
Diffstat (limited to 'usr.sbin')
-rw-r--r-- | usr.sbin/Makefile | 2 | ||||
-rw-r--r-- | usr.sbin/nvram/Makefile | 8 | ||||
-rw-r--r-- | usr.sbin/nvram/nvram.8 | 119 | ||||
-rw-r--r-- | usr.sbin/nvram/nvram.c | 222 |
4 files changed, 351 insertions, 0 deletions
diff --git a/usr.sbin/Makefile b/usr.sbin/Makefile index ea8a426..0ae2950 100644 --- a/usr.sbin/Makefile +++ b/usr.sbin/Makefile @@ -110,6 +110,7 @@ SUBDIR= ac \ nghook \ nologin \ ntp \ + ${_nvram} \ ${_ofwdump} \ ${_pccard} \ pciconf \ @@ -369,6 +370,7 @@ _zzz= zzz .if ${MACHINE_ARCH} == "powerpc" _mount_smbfs= mount_smbfs +_nvram= nvram .endif .if ${MACHINE_ARCH} == "sparc64" diff --git a/usr.sbin/nvram/Makefile b/usr.sbin/nvram/Makefile new file mode 100644 index 0000000..7abbfff --- /dev/null +++ b/usr.sbin/nvram/Makefile @@ -0,0 +1,8 @@ +# $FreeBSD$ + +PROG= nvram +MAN= nvram.8 + +WARNS?= 6 + +.include <bsd.prog.mk> diff --git a/usr.sbin/nvram/nvram.8 b/usr.sbin/nvram/nvram.8 new file mode 100644 index 0000000..63e1c21 --- /dev/null +++ b/usr.sbin/nvram/nvram.8 @@ -0,0 +1,119 @@ +.\"- +.\" Copyright (c) 2006 Maxim Sobolev <sobomax@FreeBSD.org> +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, +.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, +.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN +.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.\" +.Dd August 1, 2006 +.Dt NVRAM 8 powerpc +.Os +.Sh NAME +.Nm nvram +.Nd "display or modify contents of the EEPROM or NVRAM" +.Sh SYNOPSIS +.Nm +.Fl p +.Nm +.Op Fl d Ar name +.Op Ar name Ns = Ns Ar value +.Ar ... +.Sh DESCRIPTION +The +.Nm +utility provides an interface for displaying and changing the system's +configuration variables contained in EEPROM or NVRAM. +In the first synopsis form, all available configuration variables and their +current values are printed. +In the second form, the variable selected by +.Ar name +is either removed or its value is changed to the +.Ar value +following by +.Ql = +sign. +.Pp +The following options are available: +.Bl -tag -width indent +.It Fl d Ar name +Delete the variable selected by +.Ar name +from the EEPROM or NVRAM. The +.Fl d +flag can be specified multiple times, in which case multiple variables +will be removed. +.It Fl p +Print all available configuration variables and their current values. +.El +.Sh EXAMPLES +Print all available configuration variables and their current values: +.Pp +.Dl "nvram -p" +.Pp +Remove the variable named +.Va local-mac-address? : +.Pp +.Dl "nvram -d local-mac-address\e?" +.Pp +Set the value of the +.Va local-mac-address? +variable to +.Dq Li true : +.Pp +.Dl "nvram local-mac-address\e?=true" +.Pp +Note that the +.Ql \e +in the above examples is used to keep the shell from interpreting the +.Ql \&? . +.Pp +Remove variables named +.Va foo +and +.Va bar +and set variable named +.Va baz +to +.Dq Li 100 : +.Pp +.Dl "nvram -d foo -d bar baz=100" +.Ed +.Sh SEE ALSO +.Xr powermac_nvram 4 , +.Xr eeprom 8 +.Sh HISTORY +The +.Nm +utility first appeared in +.Fx 7.0 . +It is inspired by the +Darwin/Mac OS X +.Xr nvram 8 +utility. +.Sh AUTHORS +.An Maxim Sobolev Aq sobomax@FreeBSD.org . +.Sh BUGS +Currently, +.Nm +only supports systems equipped with AMD flash and is only tested on Apple +G4-based Mac Mini machines. diff --git a/usr.sbin/nvram/nvram.c b/usr.sbin/nvram/nvram.c new file mode 100644 index 0000000..9d56f9d --- /dev/null +++ b/usr.sbin/nvram/nvram.c @@ -0,0 +1,222 @@ +/* + * Copyright (c) 2006 Maxim Sobolev <sobomax@FreeBSD.org> + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, + * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR + * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN + * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + * + * $FreeBSD$ + */ + +#include <sys/types.h> +#include <sys/uio.h> +#include <err.h> +#include <errno.h> +#include <fcntl.h> +#include <paths.h> +#include <stdio.h> +#include <stdlib.h> +#include <string.h> +#include <unistd.h> + +#include <dev/powermac_nvram/powermac_nvramvar.h> + +#define DEVICE_NAME (_PATH_DEV "powermac_nvram") + +static void usage(void); +static int remove_var(uint8_t *, int, const char *); +static int append_var(uint8_t *, int, const char *, const char *); + +struct deletelist { + char *name; + struct deletelist *next; + struct deletelist *last; +}; + +int +main(int argc, char **argv) +{ + int opt, dump, fd, res, i, size; + uint8_t buf[NVRAM_SIZE], *cp, *common; + struct chrp_header *header; + struct deletelist *dl; + + dump = 0; + dl = NULL; + + while((opt = getopt(argc, argv, "d:p")) != -1) { + switch(opt) { + case 'p': + dump = 1; + break; + + case 'd': + if (dl == NULL) { + dl = malloc(sizeof(*dl)); + if (dl == NULL) + err(1, "malloc"); + bzero(dl, sizeof(*dl)); + dl->last = dl; + } else { + dl->last->next = malloc(sizeof(*dl)); + if (dl->last->next == NULL) + err(1, "malloc"); + dl->last = dl->last->next; + bzero(dl->last, sizeof(*dl)); + } + dl->last->name = optarg; + break; + + default: + usage(); + /* Not reached */ + } + } + argc -= optind; + argv += optind; + + if (argc == 0 && dump == 0 && dl == NULL) { + usage(); + /* Not reached */ + } + + fd = open(DEVICE_NAME, O_RDWR); + if (fd == -1) + err(1, DEVICE_NAME); + for (i = 0; i < (int)sizeof(buf);) { + res = read(fd, buf + i, sizeof(buf) - i); + if (res == -1 && errno != EINTR) + err(1, DEVICE_NAME); + if (res == 0) + break; + if (res > 0) + i += res; + } + if (i != sizeof(buf)) + errx(1, "%s: short read", DEVICE_NAME); + + /* Locate common block */ + size = 0; + for (cp = buf; cp < buf + sizeof(buf); cp += size) { + header = (struct chrp_header *)cp; + size = header->length * 0x10; + if (strncmp(header->name, "common", 7) == 0) + break; + } + if (cp >= buf + sizeof(buf) || size <= (int)sizeof(struct chrp_header)) + errx(1, "%s: no common block", DEVICE_NAME); + common = cp + sizeof(struct chrp_header); + size -= sizeof(struct chrp_header); + + if (dump != 0) { + while (size > 0) { + i = strlen(common) + 1; + if (i == 1) + break; + printf("%s\n", common); + size -= i; + common += i; + } + exit(0); + } + + for (;dl != NULL; dl = dl->next) { + if (remove_var(common, size, dl->name) == 0) + warnx("%s: no such variable", dl->name); + } + + for (; argc > 0; argc--, argv++) { + cp = strchr(*argv, '='); + if (cp == NULL) + errx(1, "%s: invalid argument", *argv); + cp[0] = '\0'; + cp++; + remove_var(common, size, *argv); + if (append_var(common, size, *argv, cp) == -1) + errx(1, "%s: error setting variable", *argv); + } + + for (i = 0; i < (int)sizeof(buf);) { + res = write(fd, buf + i, sizeof(buf) - i); + if (res == -1 && errno != EINTR) + err(1, DEVICE_NAME); + if (res == 0) + break; + if (res > 0) + i += res; + } + if (i != sizeof(buf)) + errx(1, "%s: short write", DEVICE_NAME); + if (close(fd) == -1) + err(1, DEVICE_NAME); + + exit(0); +} + +static void +usage(void) +{ + + fprintf(stderr, "usage: nvram [-p] | [-d name ...] [name=value ...]\n"); + exit(1); +} + +static int +remove_var(uint8_t *buf, int len, const char *var_name) +{ + int nremoved, i, name_len; + + nremoved = 0; + name_len = strlen(var_name); + while (len > 0) { + i = strlen(buf) + 1; + if (i == 1) + break; + if (strncmp(buf, var_name, name_len) == 0 && buf[name_len] == '=') { + memmove(buf, buf + i, len - i); + memset(buf + len - i, '\0', i); + nremoved += 1; + continue; + } + len -= i; + buf += i; + } + return nremoved; +} + +static int +append_var(uint8_t *buf, int len, const char *var_name, const char *var_value) +{ + int i, append_len; + + while (len > 0) { + i = strlen(buf) + 1; + if (i == 1) + break; + len -= i; + buf += i; + } + append_len = strlen(var_name) + strlen(var_value) + 2; + if (len < append_len) + return -1; + sprintf(buf, "%s=%s", var_name, var_value); + return 0; +} |