libdhcputil/common/dhcp_inittab.c

4  * The contents of this file are subject to the terms of the
23  * Use is subject to license terms.
60  * forward declaration of our internal inittab_table[].  too bulky to put
65  * server is extended to DHCPv6.
71  * this order is meaningful to parse_entry(); other functions should just
79  * the category_map_entry_t is used to map the inittab category codes to
81  * needs to have the codes be ORable such that queries can retrieve more
82  * than one category at a time.  this map is also used to map the inittab
83  * string representation of a category to its numerical code.
104  *	    size_t *: set to the number of entries returned
156  *	    size_t *: set to the number of entries returned
249 		 * find out whether this entry of interest to our consumer,
325 	 * due to a mistake made long ago, the first and second fields of
388  *   input: dhcp_symbol_t *: the inittab entry to verify
389  *	    dhcp_symbol_t *: if non-NULL, a place to store the internal
427  *   input: char **: pointer to string pointer
534  *		     can be put in DHCP packets to be sent on the wire.
537  *	    const char *: the value to convert
538  *	    uint16_t *: set to the length of the binary data returned
663 				 * Just copy non-ASCII text directly to the
692 						 * to treat as \00D or \0DD.
734 			 * We're done, and optstart already points to the start
735 			 * of the next in list.  Otherwise, we need to write a
736 			 * single zero byte to end the entry, if there are more
880 		/* Call libinetutil function to decode */
973 	 * if just_payload is false, then we need to add the option
1000  *	    uchar_t *: the payload to convert
1002  *	    boolean_t: if false, payload is assumed to be a DHCP option
1003  *	    int *: set to extended error code if error occurs.
1039 	 * figure out the number of elements to convert.  note that
1135 		 * octets worth of data to grab the type code.  Once we have
1327  *		     can be put in DHCP packets to be sent on the wire.
1330  *	    const char *: the value to convert
1331  *	    uint16_t *: set to the length of the binary data returned
1351  *	    uchar_t *: the payload to convert
1353  *	    boolean_t: if false, payload is assumed to be a DHCP option
1370  *	    ...: arguments to the format string
1421  *   input: uint8_t: the number of "granularity" numbers to decode
1425  *	    const uint8_t *: where to decode the numbers from
1426  *	    char *: where to decode the numbers to
1432     uint8_t granularity, const uint8_t *from, char *to, int *ierrnop)
1452 			to += sprintf(to, is_signed ? "%d" : "%u", *from);
1457 			to += sprintf(to, is_signed ? "%hd" : "%hu",
1464 			to += sprintf(to, is_signed ? "%ld" : "%lu",
1470 			to += sprintf(to, is_signed ? "%ld" : "%lu",
1476 			to += sprintf(to, is_signed ? "%lld" : "%llu",
1487 			*to++ = ' ';
1490 	*to = '\0';
1496  *		    number will end up on the wire so it needs to be in nbo
1498  *   input: uint8_t: the number of "granularity" numbers to encode
1502  *	    const uint8_t *: where to encode the numbers from
1503  *	    char *: where to encode the numbers to
1504  *	    int *: set to extended error code if error occurs.
1510     uint8_t granularity, const char *from, uint8_t *to, int *ierrnop)
1527 	for (i = 0; i < n_entries; i++, from++, to += size) {
1530 		 * totally obscure c factoid: it is legal to pass a
1531 		 * string representing a negative number to strtoul().
1533 		 * long that if cast to a long, would represent the
1534 		 * negative number.  we take advantage of this to
1542 			*to = strtoul(from, &endptr, 0);
1553 			(void) memcpy(to, &uint16, 2);
1561 			(void) memcpy(to, (uchar_t *)&uint32 + 1, 3);
1569 			(void) memcpy(to, &uint32, 4);
1577 			(void) memcpy(to, &uint64, 8);
1595 	inittab_msg("encode_number: cannot convert to integer");
1654  * itabcode_to_dsymcode(): maps an inittab category code to its dsym
1675  * category_to_code(): maps a category name to its numeric representation