457 	     struct printf_spec spec)  in number()  argument
463 	int need_pfx = ((spec.flags & SPECIAL) && spec.base != 10);  in number()
466 	int field_width = spec.field_width;  in number()
467 	int precision = spec.precision;  in number()
471 	locase = (spec.flags & SMALL);  in number()
472 	if (spec.flags & LEFT)  in number()
473 		spec.flags &= ~ZEROPAD;  in number()
475 	if (spec.flags & SIGN) {  in number()
480 		} else if (spec.flags & PLUS) {  in number()
483 		} else if (spec.flags & SPACE) {  in number()
489 		if (spec.base == 16)  in number()
497 	if (num < spec.base)  in number()
499 	else if (spec.base != 10) { /* 8 or 16 */  in number()
500 		int mask = spec.base - 1;  in number()
503 		if (spec.base == 16)  in number()
518 	if (!(spec.flags & (ZEROPAD | LEFT))) {  in number()
533 		if (spec.base == 16 || !is_zero) {  in number()
538 		if (spec.base == 16) {  in number()
545 	if (!(spec.flags & LEFT)) {  in number()
546 		char c = ' ' + (spec.flags & ZEROPAD);  in number()
579 	struct printf_spec spec;  in special_hex_number()  local
581 	spec.type = FORMAT_TYPE_PTR;  in special_hex_number()
582 	spec.field_width = 2 + 2 * size;	/* 0x + hex */  in special_hex_number()
583 	spec.flags = SPECIAL | SMALL | ZEROPAD;  in special_hex_number()
584 	spec.base = 16;  in special_hex_number()
585 	spec.precision = -1;  in special_hex_number()
587 	return number(buf, end, num, spec);  in special_hex_number()
617 char *widen_string(char *buf, int n, char *end, struct printf_spec spec)  in widen_string()  argument
621 	if (likely(n >= spec.field_width))  in widen_string()
624 	spaces = spec.field_width - n;  in widen_string()
625 	if (!(spec.flags & LEFT)) {  in widen_string()
639 			    struct printf_spec spec)  in string_nocheck()  argument
642 	int lim = spec.precision;  in string_nocheck()
653 	return widen_string(buf, len, end, spec);  in string_nocheck()
657 		     struct printf_spec spec)  in err_ptr()  argument
663 		return string_nocheck(buf, end, sym, spec);  in err_ptr()
670 	spec.flags |= SIGN;  in err_ptr()
671 	spec.base = 10;  in err_ptr()
672 	return number(buf, end, err, spec);  in err_ptr()
677 			  struct printf_spec spec)  in error_string()  argument
684 	if (spec.precision == -1)  in error_string()
685 		spec.precision = 2 * sizeof(void *);  in error_string()
687 	return string_nocheck(buf, end, s, spec);  in error_string()
707 			 struct printf_spec spec)  in check_pointer()  argument
713 		*buf = error_string(*buf, end, err_msg, spec);  in check_pointer()
722 	     struct printf_spec spec)  in string()  argument
724 	if (check_pointer(&buf, end, s, spec))  in string()
727 	return string_nocheck(buf, end, s, spec);  in string()
732 			    struct printf_spec spec)  in pointer_string()  argument
734 	spec.base = 16;  in pointer_string()
735 	spec.flags |= SMALL;  in pointer_string()
736 	if (spec.field_width == -1) {  in pointer_string()
737 		spec.field_width = 2 * sizeof(ptr);  in pointer_string()
738 		spec.flags |= ZEROPAD;  in pointer_string()
741 	return number(buf, end, (unsigned long int)ptr, spec);  in pointer_string()
807 		       struct printf_spec spec)  in ptr_to_id()  argument
818 		return pointer_string(buf, end, ptr, spec);  in ptr_to_id()
823 		return pointer_string(buf, end, (const void *)hashval, spec);  in ptr_to_id()
828 		spec.field_width = 2 * sizeof(ptr);  in ptr_to_id()
830 		return error_string(buf, end, str, spec);  in ptr_to_id()
833 	return pointer_string(buf, end, (const void *)hashval, spec);  in ptr_to_id()
837 			     struct printf_spec spec)  in default_pointer()  argument
844 		return pointer_string(buf, end, ptr, spec);  in default_pointer()
846 	return ptr_to_id(buf, end, ptr, spec);  in default_pointer()
853 			 struct printf_spec spec)  in restricted_pointer()  argument
858 		return default_pointer(buf, end, ptr, spec);  in restricted_pointer()
867 			if (spec.field_width == -1)  in restricted_pointer()
868 				spec.field_width = 2 * sizeof(ptr);  in restricted_pointer()
869 			return error_string(buf, end, "pK-error", spec);  in restricted_pointer()
895 	return pointer_string(buf, end, ptr, spec);  in restricted_pointer()
899 char *dentry_name(char *buf, char *end, const struct dentry *d, struct printf_spec spec,  in dentry_name()  argument
917 		if (check_pointer(&buf, end, d, spec)) {  in dentry_name()
932 	for (n = 0; n != spec.precision; n++, buf++) {  in dentry_name()
944 	return widen_string(buf, n, end, spec);  in dentry_name()
949 			struct printf_spec spec, const char *fmt)  in file_dentry_name()  argument
951 	if (check_pointer(&buf, end, f, spec))  in file_dentry_name()
954 	return dentry_name(buf, end, f->f_path.dentry, spec, fmt);  in file_dentry_name()
959 		struct printf_spec spec, const char *fmt)  in bdev_name()  argument
963 	if (check_pointer(&buf, end, bdev, spec))  in bdev_name()
967 	buf = string(buf, end, hd->disk_name, spec);  in bdev_name()
974 		buf = number(buf, end, bdev->bd_partno, spec);  in bdev_name()
982 		    struct printf_spec spec, const char *fmt)  in symbol_string()  argument
1005 	return string_nocheck(buf, end, sym, spec);  in symbol_string()
1043 		      struct printf_spec spec, const char *fmt)  in resource_string()  argument
1089 	if (check_pointer(&buf, end, res, spec))  in resource_string()
1139 	return string_nocheck(buf, end, sym, spec);  in resource_string()
1143 char *hex_string(char *buf, char *end, u8 *addr, struct printf_spec spec,  in hex_string()  argument
1150 	if (spec.field_width == 0)  in hex_string()
1154 	if (check_pointer(&buf, end, addr, spec))  in hex_string()
1172 	if (spec.field_width > 0)  in hex_string()
1173 		len = min_t(int, spec.field_width, 64);  in hex_string()
1195 		    struct printf_spec spec, const char *fmt)  in bitmap_string()  argument
1198 	int nr_bits = max_t(int, spec.field_width, 0);  in bitmap_string()
1202 	if (check_pointer(&buf, end, bitmap, spec))  in bitmap_string()
1206 	spec = (struct printf_spec){ .flags = SMALL | ZEROPAD, .base = 16 };  in bitmap_string()
1229 		spec.field_width = DIV_ROUND_UP(chunksz, 4);  in bitmap_string()
1230 		buf = number(buf, end, val, spec);  in bitmap_string()
1239 			 struct printf_spec spec, const char *fmt)  in bitmap_list_string()  argument
1241 	int nr_bits = max_t(int, spec.field_width, 0);  in bitmap_list_string()
1245 	if (check_pointer(&buf, end, bitmap, spec))  in bitmap_list_string()
1269 			 struct printf_spec spec, const char *fmt)  in mac_address_string()  argument
1277 	if (check_pointer(&buf, end, addr, spec))  in mac_address_string()
1305 	return string_nocheck(buf, end, mac_addr, spec);  in mac_address_string()
1459 		      struct printf_spec spec, const char *fmt)  in ip6_addr_string()  argument
1468 	return string_nocheck(buf, end, ip6_addr, spec);  in ip6_addr_string()
1473 		      struct printf_spec spec, const char *fmt)  in ip4_addr_string()  argument
1479 	return string_nocheck(buf, end, ip4_addr, spec);  in ip4_addr_string()
1484 			 struct printf_spec spec, const char *fmt)  in ip6_addr_string_sa()  argument
1528 		p = number(p, pend, ntohs(sa->sin6_port), spec);  in ip6_addr_string_sa()
1533 					  IPV6_FLOWINFO_MASK), spec);  in ip6_addr_string_sa()
1537 		p = number(p, pend, sa->sin6_scope_id, spec);  in ip6_addr_string_sa()
1541 	return string_nocheck(buf, end, ip6_addr, spec);  in ip6_addr_string_sa()
1546 			 struct printf_spec spec, const char *fmt)  in ip4_addr_string_sa()  argument
1572 		p = number(p, pend, ntohs(sa->sin_port), spec);  in ip4_addr_string_sa()
1576 	return string_nocheck(buf, end, ip4_addr, spec);  in ip4_addr_string_sa()
1581 		     struct printf_spec spec, const char *fmt)  in ip_addr_string()  argument
1585 	if (check_pointer(&buf, end, ptr, spec))  in ip_addr_string()
1590 		return ip6_addr_string(buf, end, ptr, spec, fmt);  in ip_addr_string()
1592 		return ip4_addr_string(buf, end, ptr, spec, fmt);  in ip_addr_string()
1602 			return ip4_addr_string_sa(buf, end, &sa->v4, spec, fmt);  in ip_addr_string()
1604 			return ip6_addr_string_sa(buf, end, &sa->v6, spec, fmt);  in ip_addr_string()
1606 			return error_string(buf, end, "(einval)", spec);  in ip_addr_string()
1611 	return error_string(buf, end, err_fmt_msg, spec);  in ip_addr_string()
1615 char *escaped_string(char *buf, char *end, u8 *addr, struct printf_spec spec,  in escaped_string()  argument
1623 	if (spec.field_width == 0)  in escaped_string()
1626 	if (check_pointer(&buf, end, addr, spec))  in escaped_string()
1661 	len = spec.field_width < 0 ? 1 : spec.field_width;  in escaped_string()
1674 		       struct printf_spec spec, const char *fmt)  in va_format()  argument
1678 	if (check_pointer(&buf, end, va_fmt, spec))  in va_format()
1690 		  struct printf_spec spec, const char *fmt)  in uuid_string()  argument
1698 	if (check_pointer(&buf, end, addr, spec))  in uuid_string()
1730 	return string_nocheck(buf, end, uuid, spec);  in uuid_string()
1735 		  struct printf_spec spec,  const char *fmt)  in netdev_bits()  argument
1740 	if (check_pointer(&buf, end, addr, spec))  in netdev_bits()
1749 		return error_string(buf, end, "(%pN?)", spec);  in netdev_bits()
1757 		    struct printf_spec spec, const char *fmt)  in fourcc_string()  argument
1765 		return error_string(buf, end, "(%p4?)", spec);  in fourcc_string()
1767 	if (check_pointer(&buf, end, fourcc, spec))  in fourcc_string()
1790 	return string(buf, end, output, spec);  in fourcc_string()
1795 		  struct printf_spec spec, const char *fmt)  in address_val()  argument
1800 	if (check_pointer(&buf, end, addr, spec))  in address_val()
1855 	      struct printf_spec spec, const char *fmt)  in rtc_str()  argument
1862 	if (check_pointer(&buf, end, tm, spec))  in rtc_str()
1905 		 struct printf_spec spec, const char *fmt)  in time64_str()  argument
1923 	return rtc_str(buf, end, &rtc_time, spec, fmt);  in time64_str()
1927 char *time_and_date(char *buf, char *end, void *ptr, struct printf_spec spec,  in time_and_date()  argument
1932 		return rtc_str(buf, end, (const struct rtc_time *)ptr, spec, fmt);  in time_and_date()
1934 		return time64_str(buf, end, *(const time64_t *)ptr, spec, fmt);  in time_and_date()
1936 		return error_string(buf, end, "(%pt?)", spec);  in time_and_date()
1941 char *clock(char *buf, char *end, struct clk *clk, struct printf_spec spec,  in clock()  argument
1945 		return error_string(buf, end, "(%pC?)", spec);  in clock()
1947 	if (check_pointer(&buf, end, clk, spec))  in clock()
1954 		return string(buf, end, __clk_get_name(clk), spec);  in clock()
1956 		return ptr_to_id(buf, end, clk, spec);  in clock()
1992 	const struct printf_spec *spec;  member
2045 			     *pff[i].spec);  in format_page_flags()
2077 		   struct printf_spec spec, const char *fmt)  in flags_string()  argument
2082 	if (check_pointer(&buf, end, flags_ptr, spec))  in flags_string()
2099 		return error_string(buf, end, "(%pG?)", spec);  in flags_string()
2134 			 struct printf_spec spec, const char *fmt)  in device_node_string()  argument
2143 	struct printf_spec str_spec = spec;  in device_node_string()
2147 		return error_string(buf, end, "(%pO?)", spec);  in device_node_string()
2150 		return error_string(buf, end, "(%pOF?)", spec);  in device_node_string()
2152 	if (check_pointer(&buf, end, dn, spec))  in device_node_string()
2219 	return widen_string(buf, buf - buf_start, end, spec);  in device_node_string()
2224 		    struct printf_spec spec, const char *fmt)  in fwnode_string()  argument
2226 	struct printf_spec str_spec = spec;  in fwnode_string()
2232 		return error_string(buf, end, "(%pf?)", spec);  in fwnode_string()
2234 	if (check_pointer(&buf, end, fwnode, spec))  in fwnode_string()
2249 	return widen_string(buf, buf - buf_start, end, spec);  in fwnode_string()
2413 	      struct printf_spec spec)  in pointer()  argument
2421 		return symbol_string(buf, end, ptr, spec, fmt);  in pointer()
2424 		return resource_string(buf, end, ptr, spec, fmt);  in pointer()
2426 		return hex_string(buf, end, ptr, spec, fmt);  in pointer()
2430 			return bitmap_list_string(buf, end, ptr, spec, fmt);  in pointer()
2432 			return bitmap_string(buf, end, ptr, spec, fmt);  in pointer()
2438 		return mac_address_string(buf, end, ptr, spec, fmt);  in pointer()
2448 		return ip_addr_string(buf, end, ptr, spec, fmt);  in pointer()
2450 		return escaped_string(buf, end, ptr, spec, fmt);  in pointer()
2452 		return uuid_string(buf, end, ptr, spec, fmt);  in pointer()
2454 		return va_format(buf, end, ptr, spec, fmt);  in pointer()
2456 		return restricted_pointer(buf, end, ptr, spec);  in pointer()
2458 		return netdev_bits(buf, end, ptr, spec, fmt);  in pointer()
2460 		return fourcc_string(buf, end, ptr, spec, fmt);  in pointer()
2462 		return address_val(buf, end, ptr, spec, fmt);  in pointer()
2464 		return dentry_name(buf, end, ptr, spec, fmt);  in pointer()
2466 		return time_and_date(buf, end, ptr, spec, fmt);  in pointer()
2468 		return clock(buf, end, ptr, spec, fmt);  in pointer()
2470 		return file_dentry_name(buf, end, ptr, spec, fmt);  in pointer()
2473 		return bdev_name(buf, end, ptr, spec, fmt);  in pointer()
2477 		return flags_string(buf, end, ptr, spec, fmt);  in pointer()
2479 		return device_node_string(buf, end, ptr, spec, fmt + 1);  in pointer()
2481 		return fwnode_string(buf, end, ptr, spec, fmt + 1);  in pointer()
2485 			return error_string(buf, end, "(%pA?)", spec);  in pointer()
2489 		return pointer_string(buf, end, ptr, spec);  in pointer()
2493 			return default_pointer(buf, end, ptr, spec);  in pointer()
2494 		return err_ptr(buf, end, ptr, spec);  in pointer()
2499 			return string(buf, end, ptr, spec);  in pointer()
2501 			return error_string(buf, end, "(einval)", spec);  in pointer()
2504 		return default_pointer(buf, end, ptr, spec);  in pointer()
2530 int format_decode(const char *fmt, struct printf_spec *spec)  in format_decode()  argument
2536 	if (spec->type == FORMAT_TYPE_WIDTH) {  in format_decode()
2537 		if (spec->field_width < 0) {  in format_decode()
2538 			spec->field_width = -spec->field_width;  in format_decode()
2539 			spec->flags |= LEFT;  in format_decode()
2541 		spec->type = FORMAT_TYPE_NONE;  in format_decode()
2546 	if (spec->type == FORMAT_TYPE_PRECISION) {  in format_decode()
2547 		if (spec->precision < 0)  in format_decode()
2548 			spec->precision = 0;  in format_decode()
2550 		spec->type = FORMAT_TYPE_NONE;  in format_decode()
2555 	spec->type = FORMAT_TYPE_NONE;  in format_decode()
2567 	spec->flags = 0;  in format_decode()
2575 		case '-': spec->flags |= LEFT;    break;  in format_decode()
2576 		case '+': spec->flags |= PLUS;    break;  in format_decode()
2577 		case ' ': spec->flags |= SPACE;   break;  in format_decode()
2578 		case '#': spec->flags |= SPECIAL; break;  in format_decode()
2579 		case '0': spec->flags |= ZEROPAD; break;  in format_decode()
2588 	spec->field_width = -1;  in format_decode()
2591 		spec->field_width = skip_atoi(&fmt);  in format_decode()
2594 		spec->type = FORMAT_TYPE_WIDTH;  in format_decode()
2600 	spec->precision = -1;  in format_decode()
2604 			spec->precision = skip_atoi(&fmt);  in format_decode()
2605 			if (spec->precision < 0)  in format_decode()
2606 				spec->precision = 0;  in format_decode()
2609 			spec->type = FORMAT_TYPE_PRECISION;  in format_decode()
2632 	spec->base = 10;  in format_decode()
2635 		spec->type = FORMAT_TYPE_CHAR;  in format_decode()
2639 		spec->type = FORMAT_TYPE_STR;  in format_decode()
2643 		spec->type = FORMAT_TYPE_PTR;  in format_decode()
2647 		spec->type = FORMAT_TYPE_PERCENT_CHAR;  in format_decode()
2652 		spec->base = 8;  in format_decode()
2656 		spec->flags |= SMALL;  in format_decode()
2660 		spec->base = 16;  in format_decode()
2665 		spec->flags |= SIGN;  in format_decode()
2680 		spec->type = FORMAT_TYPE_INVALID;  in format_decode()
2685 		spec->type = FORMAT_TYPE_LONG_LONG;  in format_decode()
2688 		spec->type = FORMAT_TYPE_ULONG + (spec->flags & SIGN);  in format_decode()
2690 		spec->type = FORMAT_TYPE_SIZE_T;  in format_decode()
2692 		spec->type = FORMAT_TYPE_PTRDIFF;  in format_decode()
2695 		spec->type = FORMAT_TYPE_UBYTE + (spec->flags & SIGN);  in format_decode()
2698 		spec->type = FORMAT_TYPE_USHORT + (spec->flags & SIGN);  in format_decode()
2701 		spec->type = FORMAT_TYPE_UINT + (spec->flags & SIGN);  in format_decode()
2708 set_field_width(struct printf_spec *spec, int width)  in set_field_width()  argument
2710 	spec->field_width = width;  in set_field_width()
2711 	if (WARN_ONCE(spec->field_width != width, "field width %d too large", width)) {  in set_field_width()
2712 		spec->field_width = clamp(width, -FIELD_WIDTH_MAX, FIELD_WIDTH_MAX);  in set_field_width()
2717 set_precision(struct printf_spec *spec, int prec)  in set_precision()  argument
2719 	spec->precision = prec;  in set_precision()
2720 	if (WARN_ONCE(spec->precision != prec, "precision %d too large", prec)) {  in set_precision()
2721 		spec->precision = clamp(prec, 0, PRECISION_MAX);  in set_precision()
2757 	struct printf_spec spec = {0};  in vsnprintf()  local
2775 		int read = format_decode(fmt, &spec);  in vsnprintf()
2779 		switch (spec.type) {  in vsnprintf()
2792 			set_field_width(&spec, va_arg(args, int));  in vsnprintf()
2796 			set_precision(&spec, va_arg(args, int));  in vsnprintf()
2802 			if (!(spec.flags & LEFT)) {  in vsnprintf()
2803 				while (--spec.field_width > 0) {  in vsnprintf()
2814 			while (--spec.field_width > 0) {  in vsnprintf()
2823 			str = string(str, end, va_arg(args, char *), spec);  in vsnprintf()
2828 				      spec);  in vsnprintf()
2851 			switch (spec.type) {  in vsnprintf()
2862 				if (spec.flags & SIGN)  in vsnprintf()
2889 			str = number(str, end, num, spec);  in vsnprintf()
3060 	struct printf_spec spec = {0};  in vbin_printf()  local
3092 		int read = format_decode(fmt, &spec);  in vbin_printf()
3096 		switch (spec.type) {  in vbin_printf()
3108 				set_field_width(&spec, width);  in vbin_printf()
3148 					      spec);  in vbin_printf()
3160 			switch (spec.type) {  in vbin_printf()
3219 	struct printf_spec spec = {0};  in bstr_printf()  local
3252 		int read = format_decode(fmt, &spec);  in bstr_printf()
3256 		switch (spec.type) {  in bstr_printf()
3269 			set_field_width(&spec, get_arg(int));  in bstr_printf()
3273 			set_precision(&spec, get_arg(int));  in bstr_printf()
3279 			if (!(spec.flags & LEFT)) {  in bstr_printf()
3280 				while (--spec.field_width > 0) {  in bstr_printf()
3290 			while (--spec.field_width > 0) {  in bstr_printf()
3301 			str = string(str, end, (char *)str_arg, spec);  in bstr_printf()
3333 				str = pointer(fmt, str, end, get_arg(void *), spec);  in bstr_printf()
3352 			switch (spec.type) {  in bstr_printf()
3386 			str = number(str, end, num, spec);  in bstr_printf()