Home | History | Annotate | Line # | Download | only in libsa
bootcfg.c revision 1.7
      1 /*	$NetBSD: bootcfg.c,v 1.7 2021/09/07 11:41:31 nia Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 2008 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * Redistribution and use in source and binary forms, with or without
      8  * modification, are permitted provided that the following conditions
      9  * are met:
     10  * 1. Redistributions of source code must retain the above copyright
     11  *    notice, this list of conditions and the following disclaimer.
     12  * 2. Redistributions in binary form must reproduce the above copyright
     13  *    notice, this list of conditions and the following disclaimer in the
     14  *    documentation and/or other materials provided with the distribution.
     15  *
     16  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     17  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     18  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     19  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     20  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     21  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     22  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     23  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     24  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     25  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     26  * POSSIBILITY OF SUCH DAMAGE.
     27  */
     28 
     29 #include <sys/types.h>
     30 #include <sys/reboot.h>
     31 
     32 #include <lib/libsa/stand.h>
     33 #include <lib/libsa/bootcfg.h>
     34 #include <lib/libkern/libkern.h>
     35 
     36 #define MENUFORMAT_AUTO   0
     37 #define MENUFORMAT_NUMBER 1
     38 #define MENUFORMAT_LETTER 2
     39 
     40 #define DEFAULT_FORMAT  MENUFORMAT_AUTO
     41 #define DEFAULT_TIMEOUT 10
     42 
     43 struct bootcfg_def bootcfg_info;
     44 
     45 void
     46 bootcfg_do_noop(const char *cmd, char *arg)
     47 {
     48 	/* noop, do nothing */
     49 }
     50 
     51 /*
     52  * This function parses a boot.cfg file in the root of the filesystem
     53  * (if present) and populates the global boot configuration.
     54  *
     55  * The file consists of a number of lines each terminated by \n
     56  * The lines are in the format keyword=value. There should not be spaces
     57  * around the = sign.
     58  *
     59  * perform_bootcfg(conf, command, maxsz)
     60  *
     61  * conf		Path to boot.cfg to be passed verbatim to open()
     62  *
     63  * command	Pointer to a function that will be called when
     64  * 		perform_bootcfg() encounters a key (command) it does not
     65  *		recognize.
     66  *		The command function is provided both the keyword and
     67  *		value parsed as arguments to the function.
     68  *
     69  * maxsz	Limit the size of the boot.cfg perform_bootcfg() will parse.
     70  * 		- If maxsz is < 0 boot.cfg will not be processed.
     71  * 		- If maxsz is = 0 no limit will be imposed but parsing may
     72  *		  fail due to platform or other constraints e.g. maximum
     73  *		  segment size.
     74  *		- If 0 < maxsz and boot.cfg exceeds maxsz it will not be
     75  *		  parsed, otherwise it will be parsed.
     76  *
     77  * The recognised keywords are:
     78  * banner: text displayed instead of the normal welcome text
     79  * menu: Descriptive text:command to use
     80  * timeout: Timeout in seconds (overrides that set by installboot)
     81  * default: the default menu option to use if Return is pressed
     82  * consdev: the console device to use
     83  * root: the root device to use
     84  * format: how menu choices are displayed: (a)utomatic, (n)umbers or (l)etters
     85  * clear: whether to clear the screen or not
     86  *
     87  * Example boot.cfg file:
     88  * banner=Welcome to NetBSD
     89  * banner=Please choose the boot type from the following menu
     90  * menu=Boot NetBSD:boot netbsd
     91  * menu=Boot into single user mode:boot netbsd -s
     92  * menu=:boot hd1a:netbsd -cs
     93  * menu=Goto boot comand line:prompt
     94  * timeout=10
     95  * consdev=com0
     96  * default=1
     97 */
     98 int
     99 perform_bootcfg(const char *conf, bootcfg_command command, const off_t maxsz)
    100 {
    101 	char *bc, *c;
    102 	int cmenu, cbanner;
    103 	ssize_t len, off, resid;
    104 	int fd, err;
    105 	struct stat st;
    106 	char *next, *key, *value, *v2;
    107 
    108 	/* clear bootcfg structure */
    109 	memset(&bootcfg_info, 0, sizeof(bootcfg_info));
    110 
    111 	/* set default timeout */
    112 	bootcfg_info.timeout = DEFAULT_TIMEOUT;
    113 
    114 	/* automatically switch between letter and numbers on menu */
    115 	bootcfg_info.menuformat = DEFAULT_FORMAT;
    116 
    117 	fd = open(conf, 0);
    118 	if (fd < 0)
    119 		return ENOENT;
    120 
    121 	err = fstat(fd, &st);
    122 	if (err == -1) {
    123 		/* file descriptor may not be backed by a libsa file-system */
    124 		st.st_size = maxsz;
    125 	}
    126 
    127 	/* if a maximum size is being requested for the boot.cfg enforce it. */
    128 	if (0 < maxsz && st.st_size > maxsz) {
    129 		close(fd);
    130 		return EFBIG;
    131 	}
    132 
    133 	bc = alloc((size_t)st.st_size + 1);
    134 	if (bc == NULL) {
    135 		printf("Could not allocate memory for boot configuration\n");
    136 		close(fd);
    137 		return ENOMEM;
    138 	}
    139 
    140 	/*
    141 	 * XXX original code, assumes error or eof return from read()
    142 	 *     results in the entire boot.cfg being buffered.
    143 	 *     - should bail out on read() failing.
    144 	 *     - assumption is made that the file size doesn't change between
    145 	 *       fstat() and read()ing.  probably safe in this context
    146 	 *       arguably should check that reading the file won't overflow
    147 	 *       the storage anyway.
    148 	 */
    149 	off = 0;
    150 	resid = st.st_size;
    151 	do {
    152 		len = read(fd, bc + off, uimin(1024, resid));
    153 		if (len <= 0)
    154 			break;
    155 		off += len;
    156 		resid -= len;
    157 	} while (len > 0 && resid > 0);
    158 	bc[off] = '\0';
    159 
    160 	close(fd);
    161 
    162 	/* bc is now assumed to contain the whole boot.cfg file (see above) */
    163 
    164 	cmenu = 0;
    165 	cbanner = 0;
    166 	for (c = bc; *c; c = next) {
    167 		key = c;
    168 		/* find end of line */
    169 		for (; *c && *c != '\n'; c++)
    170 			/* zero terminate line on start of comment */
    171 			if (*c == '#')
    172 				*c = 0;
    173 		/* zero terminate line */
    174 		if (*(next = c))
    175 			*next++ = 0;
    176 		/* Look for = separator between key and value */
    177 		for (c = key; *c && *c != '='; c++)
    178 			continue;
    179 		/* Ignore lines with no key=value pair */
    180 		if (*c == '\0')
    181 			continue;
    182 
    183 		/* zero terminate key which points to keyword */
    184 		*c++ = 0;
    185 		value = c;
    186 		/* Look for end of line (or file) and zero terminate value */
    187 		for (; *c && *c != '\n'; c++)
    188 			continue;
    189 		*c = 0;
    190 
    191 		if (!strncmp(key, "menu", 4)) {
    192 			/*
    193 			 * Parse "menu=<description>:<command>".  If the
    194 			 * description is empty ("menu=:<command>)",
    195 			 * then re-use the command as the description.
    196 			 * Note that the command may contain embedded
    197 			 * colons.
    198 			 */
    199 			if (cmenu >= BOOTCFG_MAXMENU)
    200 				continue;
    201 			bootcfg_info.desc[cmenu] = value;
    202 			for (v2 = value; *v2 && *v2 != ':'; v2++)
    203 				continue;
    204 			if (*v2) {
    205 				*v2++ = 0;
    206 				bootcfg_info.command[cmenu] = v2;
    207 				if (! *value)
    208 					bootcfg_info.desc[cmenu] = v2;
    209 				cmenu++;
    210 			} else {
    211 				/* No delimiter means invalid line */
    212 				bootcfg_info.desc[cmenu] = NULL;
    213 			}
    214 		} else if (!strncmp(key, "banner", 6)) {
    215 			if (cbanner < BOOTCFG_MAXBANNER)
    216 				bootcfg_info.banner[cbanner++] = value;
    217 		} else if (!strncmp(key, "timeout", 7)) {
    218 			if (!isdigit(*value))
    219 				bootcfg_info.timeout = -1;
    220 			else
    221 				bootcfg_info.timeout = atoi(value);
    222 		} else if (!strncmp(key, "default", 7)) {
    223 			bootcfg_info.def = atoi(value) - 1;
    224 		} else if (!strncmp(key, "consdev", 7)) {
    225 			bootcfg_info.consdev = value;
    226 		} else if (!strncmp(key, "root", 4)) {
    227 			bootcfg_info.root = value;
    228 		} else if (!strncmp(key, BOOTCFG_CMD_LOAD, 4)) {
    229 			command(BOOTCFG_CMD_LOAD, value);
    230 		} else if (!strncmp(key, "format", 6)) {
    231 			printf("value:%c\n", *value);
    232 			switch (*value) {
    233 			case 'a':
    234 			case 'A':
    235 				bootcfg_info.menuformat = MENUFORMAT_AUTO;
    236 				break;
    237 
    238 			case 'n':
    239 			case 'N':
    240 			case 'd':
    241 			case 'D':
    242 				bootcfg_info.menuformat = MENUFORMAT_NUMBER;
    243 				break;
    244 
    245 			case 'l':
    246 			case 'L':
    247 				bootcfg_info.menuformat = MENUFORMAT_LETTER;
    248 				break;
    249 			}
    250 		} else if (!strncmp(key, "clear", 5)) {
    251 			bootcfg_info.clear = !!atoi(value);
    252 		} else if (!strncmp(key, BOOTCFG_CMD_USERCONF, 8)) {
    253 			command(BOOTCFG_CMD_USERCONF, value);
    254 		} else {
    255 			command(key, value);
    256 		}
    257 	}
    258 
    259 	switch (bootcfg_info.menuformat) {
    260 	case MENUFORMAT_AUTO:
    261 		if (cmenu > 9 && bootcfg_info.timeout > 0)
    262 			bootcfg_info.menuformat = MENUFORMAT_LETTER;
    263 		else
    264 			bootcfg_info.menuformat = MENUFORMAT_NUMBER;
    265 		break;
    266 
    267 	case MENUFORMAT_NUMBER:
    268 		if (cmenu > 9 && bootcfg_info.timeout > 0)
    269 			cmenu = 9;
    270 		break;
    271 	}
    272 
    273 	bootcfg_info.nummenu = cmenu;
    274 	if (bootcfg_info.def < 0)
    275 		bootcfg_info.def = 0;
    276 	if (bootcfg_info.def >= cmenu)
    277 		bootcfg_info.def = cmenu - 1;
    278 
    279 	return 0;
    280 }
    281 
    282 void
    283 print_bootcfg_banner(const char *bootprog_name, const char *bootprog_rev)
    284 {
    285 	int n = 0;
    286 
    287 	if (bootcfg_info.banner[0]) {
    288 		for (; n < BOOTCFG_MAXBANNER && bootcfg_info.banner[n]; n++)
    289 			printf("%s\n", bootcfg_info.banner[n]);
    290 		return;
    291 	}
    292 
    293 	/* If the user has not specified a banner, print a default one. */
    294 
    295 	printf("\n");
    296 	printf("  \\\\-__,------,___.\n");
    297 	printf("   \\\\        __,---`  %s\n", bootprog_name);
    298 	printf("    \\\\       `---,_.  Revision %s\n", bootprog_rev);
    299 	printf("     \\\\-,_____,.---`\n");
    300 	printf("      \\\\\n");
    301 	printf("       \\\\\n");
    302 	printf("        \\\\\n\n");
    303 }
    304