| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* | 
 | 2 |  *  linux/lib/vsprintf.c | 
 | 3 |  * | 
 | 4 |  *  Copyright (C) 1991, 1992  Linus Torvalds | 
 | 5 |  */ | 
 | 6 |  | 
 | 7 | /* vsprintf.c -- Lars Wirzenius & Linus Torvalds. */ | 
 | 8 | /* | 
 | 9 |  * Wirzenius wrote this portably, Torvalds fucked it up :-) | 
 | 10 |  */ | 
 | 11 |  | 
 | 12 | /*  | 
 | 13 |  * Fri Jul 13 2001 Crutcher Dunnavant <crutcher+kernel@datastacks.com> | 
 | 14 |  * - changed to provide snprintf and vsnprintf functions | 
 | 15 |  * So Feb  1 16:51:32 CET 2004 Juergen Quade <quade@hsnr.de> | 
 | 16 |  * - scnprintf and vscnprintf | 
 | 17 |  */ | 
 | 18 |  | 
 | 19 | #include <stdarg.h> | 
 | 20 | #include <linux/module.h> | 
 | 21 | #include <linux/types.h> | 
 | 22 | #include <linux/string.h> | 
 | 23 | #include <linux/ctype.h> | 
 | 24 | #include <linux/kernel.h> | 
 | 25 |  | 
| Tim Schmielau | 4e57b68 | 2005-10-30 15:03:48 -0800 | [diff] [blame] | 26 | #include <asm/page.h>		/* for PAGE_SIZE */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 27 | #include <asm/div64.h> | 
 | 28 |  | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 29 | /* Works only for digits and letters, but small and fast */ | 
 | 30 | #define TOLOWER(x) ((x) | 0x20) | 
 | 31 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 32 | /** | 
 | 33 |  * simple_strtoul - convert a string to an unsigned long | 
 | 34 |  * @cp: The start of the string | 
 | 35 |  * @endp: A pointer to the end of the parsed string will be placed here | 
 | 36 |  * @base: The number base to use | 
 | 37 |  */ | 
 | 38 | unsigned long simple_strtoul(const char *cp,char **endp,unsigned int base) | 
 | 39 | { | 
 | 40 | 	unsigned long result = 0,value; | 
 | 41 |  | 
 | 42 | 	if (!base) { | 
 | 43 | 		base = 10; | 
 | 44 | 		if (*cp == '0') { | 
 | 45 | 			base = 8; | 
 | 46 | 			cp++; | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 47 | 			if ((TOLOWER(*cp) == 'x') && isxdigit(cp[1])) { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 48 | 				cp++; | 
 | 49 | 				base = 16; | 
 | 50 | 			} | 
 | 51 | 		} | 
 | 52 | 	} else if (base == 16) { | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 53 | 		if (cp[0] == '0' && TOLOWER(cp[1]) == 'x') | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 54 | 			cp += 2; | 
 | 55 | 	} | 
 | 56 | 	while (isxdigit(*cp) && | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 57 | 	       (value = isdigit(*cp) ? *cp-'0' : TOLOWER(*cp)-'a'+10) < base) { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 58 | 		result = result*base + value; | 
 | 59 | 		cp++; | 
 | 60 | 	} | 
 | 61 | 	if (endp) | 
 | 62 | 		*endp = (char *)cp; | 
 | 63 | 	return result; | 
 | 64 | } | 
 | 65 |  | 
 | 66 | EXPORT_SYMBOL(simple_strtoul); | 
 | 67 |  | 
 | 68 | /** | 
 | 69 |  * simple_strtol - convert a string to a signed long | 
 | 70 |  * @cp: The start of the string | 
 | 71 |  * @endp: A pointer to the end of the parsed string will be placed here | 
 | 72 |  * @base: The number base to use | 
 | 73 |  */ | 
 | 74 | long simple_strtol(const char *cp,char **endp,unsigned int base) | 
 | 75 | { | 
 | 76 | 	if(*cp=='-') | 
 | 77 | 		return -simple_strtoul(cp+1,endp,base); | 
 | 78 | 	return simple_strtoul(cp,endp,base); | 
 | 79 | } | 
 | 80 |  | 
 | 81 | EXPORT_SYMBOL(simple_strtol); | 
 | 82 |  | 
 | 83 | /** | 
 | 84 |  * simple_strtoull - convert a string to an unsigned long long | 
 | 85 |  * @cp: The start of the string | 
 | 86 |  * @endp: A pointer to the end of the parsed string will be placed here | 
 | 87 |  * @base: The number base to use | 
 | 88 |  */ | 
 | 89 | unsigned long long simple_strtoull(const char *cp,char **endp,unsigned int base) | 
 | 90 | { | 
 | 91 | 	unsigned long long result = 0,value; | 
 | 92 |  | 
 | 93 | 	if (!base) { | 
 | 94 | 		base = 10; | 
 | 95 | 		if (*cp == '0') { | 
 | 96 | 			base = 8; | 
 | 97 | 			cp++; | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 98 | 			if ((TOLOWER(*cp) == 'x') && isxdigit(cp[1])) { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 99 | 				cp++; | 
 | 100 | 				base = 16; | 
 | 101 | 			} | 
 | 102 | 		} | 
 | 103 | 	} else if (base == 16) { | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 104 | 		if (cp[0] == '0' && TOLOWER(cp[1]) == 'x') | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 105 | 			cp += 2; | 
 | 106 | 	} | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 107 | 	while (isxdigit(*cp) | 
 | 108 | 	 && (value = isdigit(*cp) ? *cp-'0' : TOLOWER(*cp)-'a'+10) < base) { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 109 | 		result = result*base + value; | 
 | 110 | 		cp++; | 
 | 111 | 	} | 
 | 112 | 	if (endp) | 
 | 113 | 		*endp = (char *)cp; | 
 | 114 | 	return result; | 
 | 115 | } | 
 | 116 |  | 
 | 117 | EXPORT_SYMBOL(simple_strtoull); | 
 | 118 |  | 
 | 119 | /** | 
 | 120 |  * simple_strtoll - convert a string to a signed long long | 
 | 121 |  * @cp: The start of the string | 
 | 122 |  * @endp: A pointer to the end of the parsed string will be placed here | 
 | 123 |  * @base: The number base to use | 
 | 124 |  */ | 
 | 125 | long long simple_strtoll(const char *cp,char **endp,unsigned int base) | 
 | 126 | { | 
 | 127 | 	if(*cp=='-') | 
 | 128 | 		return -simple_strtoull(cp+1,endp,base); | 
 | 129 | 	return simple_strtoull(cp,endp,base); | 
 | 130 | } | 
 | 131 |  | 
| Yi Yang | 06b2a76 | 2008-02-08 04:21:57 -0800 | [diff] [blame] | 132 |  | 
 | 133 | /** | 
 | 134 |  * strict_strtoul - convert a string to an unsigned long strictly | 
 | 135 |  * @cp: The string to be converted | 
 | 136 |  * @base: The number base to use | 
 | 137 |  * @res: The converted result value | 
 | 138 |  * | 
 | 139 |  * strict_strtoul converts a string to an unsigned long only if the | 
 | 140 |  * string is really an unsigned long string, any string containing | 
 | 141 |  * any invalid char at the tail will be rejected and -EINVAL is returned, | 
 | 142 |  * only a newline char at the tail is acceptible because people generally | 
 | 143 |  * change a module parameter in the following way: | 
 | 144 |  * | 
 | 145 |  * 	echo 1024 > /sys/module/e1000/parameters/copybreak | 
 | 146 |  * | 
 | 147 |  * echo will append a newline to the tail. | 
 | 148 |  * | 
 | 149 |  * It returns 0 if conversion is successful and *res is set to the converted | 
 | 150 |  * value, otherwise it returns -EINVAL and *res is set to 0. | 
 | 151 |  * | 
 | 152 |  * simple_strtoul just ignores the successive invalid characters and | 
 | 153 |  * return the converted value of prefix part of the string. | 
 | 154 |  */ | 
 | 155 | int strict_strtoul(const char *cp, unsigned int base, unsigned long *res); | 
 | 156 |  | 
 | 157 | /** | 
 | 158 |  * strict_strtol - convert a string to a long strictly | 
 | 159 |  * @cp: The string to be converted | 
 | 160 |  * @base: The number base to use | 
 | 161 |  * @res: The converted result value | 
 | 162 |  * | 
 | 163 |  * strict_strtol is similiar to strict_strtoul, but it allows the first | 
 | 164 |  * character of a string is '-'. | 
 | 165 |  * | 
 | 166 |  * It returns 0 if conversion is successful and *res is set to the converted | 
 | 167 |  * value, otherwise it returns -EINVAL and *res is set to 0. | 
 | 168 |  */ | 
 | 169 | int strict_strtol(const char *cp, unsigned int base, long *res); | 
 | 170 |  | 
 | 171 | /** | 
 | 172 |  * strict_strtoull - convert a string to an unsigned long long strictly | 
 | 173 |  * @cp: The string to be converted | 
 | 174 |  * @base: The number base to use | 
 | 175 |  * @res: The converted result value | 
 | 176 |  * | 
 | 177 |  * strict_strtoull converts a string to an unsigned long long only if the | 
 | 178 |  * string is really an unsigned long long string, any string containing | 
 | 179 |  * any invalid char at the tail will be rejected and -EINVAL is returned, | 
 | 180 |  * only a newline char at the tail is acceptible because people generally | 
 | 181 |  * change a module parameter in the following way: | 
 | 182 |  * | 
 | 183 |  * 	echo 1024 > /sys/module/e1000/parameters/copybreak | 
 | 184 |  * | 
 | 185 |  * echo will append a newline to the tail of the string. | 
 | 186 |  * | 
 | 187 |  * It returns 0 if conversion is successful and *res is set to the converted | 
 | 188 |  * value, otherwise it returns -EINVAL and *res is set to 0. | 
 | 189 |  * | 
 | 190 |  * simple_strtoull just ignores the successive invalid characters and | 
 | 191 |  * return the converted value of prefix part of the string. | 
 | 192 |  */ | 
 | 193 | int strict_strtoull(const char *cp, unsigned int base, unsigned long long *res); | 
 | 194 |  | 
 | 195 | /** | 
 | 196 |  * strict_strtoll - convert a string to a long long strictly | 
 | 197 |  * @cp: The string to be converted | 
 | 198 |  * @base: The number base to use | 
 | 199 |  * @res: The converted result value | 
 | 200 |  * | 
 | 201 |  * strict_strtoll is similiar to strict_strtoull, but it allows the first | 
 | 202 |  * character of a string is '-'. | 
 | 203 |  * | 
 | 204 |  * It returns 0 if conversion is successful and *res is set to the converted | 
 | 205 |  * value, otherwise it returns -EINVAL and *res is set to 0. | 
 | 206 |  */ | 
 | 207 | int strict_strtoll(const char *cp, unsigned int base, long long *res); | 
 | 208 |  | 
 | 209 | #define define_strict_strtoux(type, valtype)				\ | 
 | 210 | int strict_strtou##type(const char *cp, unsigned int base, valtype *res)\ | 
 | 211 | {									\ | 
 | 212 | 	char *tail;							\ | 
 | 213 | 	valtype val;							\ | 
 | 214 | 	size_t len;							\ | 
 | 215 | 									\ | 
 | 216 | 	*res = 0;							\ | 
 | 217 | 	len = strlen(cp);						\ | 
 | 218 | 	if (len == 0)							\ | 
 | 219 | 		return -EINVAL;						\ | 
 | 220 | 									\ | 
 | 221 | 	val = simple_strtoul(cp, &tail, base);				\ | 
 | 222 | 	if ((*tail == '\0') ||						\ | 
 | 223 | 		((len == (size_t)(tail - cp) + 1) && (*tail == '\n'))) {\ | 
 | 224 | 		*res = val;						\ | 
 | 225 | 		return 0;						\ | 
 | 226 | 	}								\ | 
 | 227 | 									\ | 
 | 228 | 	return -EINVAL;							\ | 
 | 229 | }									\ | 
 | 230 |  | 
 | 231 | #define define_strict_strtox(type, valtype)				\ | 
 | 232 | int strict_strto##type(const char *cp, unsigned int base, valtype *res)	\ | 
 | 233 | {									\ | 
 | 234 | 	int ret;							\ | 
 | 235 | 	if (*cp == '-') {						\ | 
 | 236 | 		ret = strict_strtou##type(cp+1, base, res);		\ | 
| Hoang-Nam Nguyen | 4f9d5f4 | 2008-02-23 15:23:37 -0800 | [diff] [blame] | 237 | 		if (!ret)						\ | 
| Yi Yang | 06b2a76 | 2008-02-08 04:21:57 -0800 | [diff] [blame] | 238 | 			*res = -(*res);					\ | 
 | 239 | 	} else								\ | 
 | 240 | 		ret = strict_strtou##type(cp, base, res);		\ | 
 | 241 | 									\ | 
 | 242 | 	return ret;							\ | 
 | 243 | }									\ | 
 | 244 |  | 
 | 245 | define_strict_strtoux(l, unsigned long) | 
 | 246 | define_strict_strtox(l, long) | 
 | 247 | define_strict_strtoux(ll, unsigned long long) | 
 | 248 | define_strict_strtox(ll, long long) | 
 | 249 |  | 
 | 250 | EXPORT_SYMBOL(strict_strtoul); | 
 | 251 | EXPORT_SYMBOL(strict_strtol); | 
 | 252 | EXPORT_SYMBOL(strict_strtoll); | 
 | 253 | EXPORT_SYMBOL(strict_strtoull); | 
 | 254 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 255 | static int skip_atoi(const char **s) | 
 | 256 | { | 
 | 257 | 	int i=0; | 
 | 258 |  | 
 | 259 | 	while (isdigit(**s)) | 
 | 260 | 		i = i*10 + *((*s)++) - '0'; | 
 | 261 | 	return i; | 
 | 262 | } | 
 | 263 |  | 
| Denis Vlasenko | 4277eed | 2007-07-15 23:41:56 -0700 | [diff] [blame] | 264 | /* Decimal conversion is by far the most typical, and is used | 
 | 265 |  * for /proc and /sys data. This directly impacts e.g. top performance | 
 | 266 |  * with many processes running. We optimize it for speed | 
 | 267 |  * using code from | 
 | 268 |  * http://www.cs.uiowa.edu/~jones/bcd/decimal.html | 
 | 269 |  * (with permission from the author, Douglas W. Jones). */ | 
 | 270 |  | 
 | 271 | /* Formats correctly any integer in [0,99999]. | 
 | 272 |  * Outputs from one to five digits depending on input. | 
 | 273 |  * On i386 gcc 4.1.2 -O2: ~250 bytes of code. */ | 
 | 274 | static char* put_dec_trunc(char *buf, unsigned q) | 
 | 275 | { | 
 | 276 | 	unsigned d3, d2, d1, d0; | 
 | 277 | 	d1 = (q>>4) & 0xf; | 
 | 278 | 	d2 = (q>>8) & 0xf; | 
 | 279 | 	d3 = (q>>12); | 
 | 280 |  | 
 | 281 | 	d0 = 6*(d3 + d2 + d1) + (q & 0xf); | 
 | 282 | 	q = (d0 * 0xcd) >> 11; | 
 | 283 | 	d0 = d0 - 10*q; | 
 | 284 | 	*buf++ = d0 + '0'; /* least significant digit */ | 
 | 285 | 	d1 = q + 9*d3 + 5*d2 + d1; | 
 | 286 | 	if (d1 != 0) { | 
 | 287 | 		q = (d1 * 0xcd) >> 11; | 
 | 288 | 		d1 = d1 - 10*q; | 
 | 289 | 		*buf++ = d1 + '0'; /* next digit */ | 
 | 290 |  | 
 | 291 | 		d2 = q + 2*d2; | 
 | 292 | 		if ((d2 != 0) || (d3 != 0)) { | 
 | 293 | 			q = (d2 * 0xd) >> 7; | 
 | 294 | 			d2 = d2 - 10*q; | 
 | 295 | 			*buf++ = d2 + '0'; /* next digit */ | 
 | 296 |  | 
 | 297 | 			d3 = q + 4*d3; | 
 | 298 | 			if (d3 != 0) { | 
 | 299 | 				q = (d3 * 0xcd) >> 11; | 
 | 300 | 				d3 = d3 - 10*q; | 
 | 301 | 				*buf++ = d3 + '0';  /* next digit */ | 
 | 302 | 				if (q != 0) | 
 | 303 | 					*buf++ = q + '0';  /* most sign. digit */ | 
 | 304 | 			} | 
 | 305 | 		} | 
 | 306 | 	} | 
 | 307 | 	return buf; | 
 | 308 | } | 
 | 309 | /* Same with if's removed. Always emits five digits */ | 
 | 310 | static char* put_dec_full(char *buf, unsigned q) | 
 | 311 | { | 
 | 312 | 	/* BTW, if q is in [0,9999], 8-bit ints will be enough, */ | 
 | 313 | 	/* but anyway, gcc produces better code with full-sized ints */ | 
 | 314 | 	unsigned d3, d2, d1, d0; | 
 | 315 | 	d1 = (q>>4) & 0xf; | 
 | 316 | 	d2 = (q>>8) & 0xf; | 
 | 317 | 	d3 = (q>>12); | 
 | 318 |  | 
 | 319 | 	/* Possible ways to approx. divide by 10 */ | 
 | 320 | 	/* gcc -O2 replaces multiply with shifts and adds */ | 
 | 321 | 	// (x * 0xcd) >> 11: 11001101 - shorter code than * 0x67 (on i386) | 
 | 322 | 	// (x * 0x67) >> 10:  1100111 | 
 | 323 | 	// (x * 0x34) >> 9:    110100 - same | 
 | 324 | 	// (x * 0x1a) >> 8:     11010 - same | 
 | 325 | 	// (x * 0x0d) >> 7:      1101 - same, shortest code (on i386) | 
 | 326 |  | 
 | 327 | 	d0 = 6*(d3 + d2 + d1) + (q & 0xf); | 
 | 328 | 	q = (d0 * 0xcd) >> 11; | 
 | 329 | 	d0 = d0 - 10*q; | 
 | 330 | 	*buf++ = d0 + '0'; | 
 | 331 | 	d1 = q + 9*d3 + 5*d2 + d1; | 
 | 332 | 		q = (d1 * 0xcd) >> 11; | 
 | 333 | 		d1 = d1 - 10*q; | 
 | 334 | 		*buf++ = d1 + '0'; | 
 | 335 |  | 
 | 336 | 		d2 = q + 2*d2; | 
 | 337 | 			q = (d2 * 0xd) >> 7; | 
 | 338 | 			d2 = d2 - 10*q; | 
 | 339 | 			*buf++ = d2 + '0'; | 
 | 340 |  | 
 | 341 | 			d3 = q + 4*d3; | 
 | 342 | 				q = (d3 * 0xcd) >> 11; /* - shorter code */ | 
 | 343 | 				/* q = (d3 * 0x67) >> 10; - would also work */ | 
 | 344 | 				d3 = d3 - 10*q; | 
 | 345 | 				*buf++ = d3 + '0'; | 
 | 346 | 					*buf++ = q + '0'; | 
 | 347 | 	return buf; | 
 | 348 | } | 
 | 349 | /* No inlining helps gcc to use registers better */ | 
 | 350 | static noinline char* put_dec(char *buf, unsigned long long num) | 
 | 351 | { | 
 | 352 | 	while (1) { | 
 | 353 | 		unsigned rem; | 
 | 354 | 		if (num < 100000) | 
 | 355 | 			return put_dec_trunc(buf, num); | 
 | 356 | 		rem = do_div(num, 100000); | 
 | 357 | 		buf = put_dec_full(buf, rem); | 
 | 358 | 	} | 
 | 359 | } | 
 | 360 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 361 | #define ZEROPAD	1		/* pad with zero */ | 
 | 362 | #define SIGN	2		/* unsigned/signed long */ | 
 | 363 | #define PLUS	4		/* show plus */ | 
 | 364 | #define SPACE	8		/* space if plus */ | 
 | 365 | #define LEFT	16		/* left justified */ | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 366 | #define SMALL	32		/* Must be 32 == 0x20 */ | 
 | 367 | #define SPECIAL	64		/* 0x */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 368 |  | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 369 | static char *number(char *buf, char *end, unsigned long long num, int base, int size, int precision, int type) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 370 | { | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 371 | 	/* we are called with base 8, 10 or 16, only, thus don't need "G..."  */ | 
 | 372 | 	static const char digits[16] = "0123456789ABCDEF"; /* "GHIJKLMNOPQRSTUVWXYZ"; */ | 
 | 373 |  | 
 | 374 | 	char tmp[66]; | 
 | 375 | 	char sign; | 
 | 376 | 	char locase; | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 377 | 	int need_pfx = ((type & SPECIAL) && base != 10); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 378 | 	int i; | 
 | 379 |  | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 380 | 	/* locase = 0 or 0x20. ORing digits or letters with 'locase' | 
 | 381 | 	 * produces same digits or (maybe lowercased) letters */ | 
 | 382 | 	locase = (type & SMALL); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 383 | 	if (type & LEFT) | 
 | 384 | 		type &= ~ZEROPAD; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 385 | 	sign = 0; | 
 | 386 | 	if (type & SIGN) { | 
 | 387 | 		if ((signed long long) num < 0) { | 
 | 388 | 			sign = '-'; | 
 | 389 | 			num = - (signed long long) num; | 
 | 390 | 			size--; | 
 | 391 | 		} else if (type & PLUS) { | 
 | 392 | 			sign = '+'; | 
 | 393 | 			size--; | 
 | 394 | 		} else if (type & SPACE) { | 
 | 395 | 			sign = ' '; | 
 | 396 | 			size--; | 
 | 397 | 		} | 
 | 398 | 	} | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 399 | 	if (need_pfx) { | 
 | 400 | 		size--; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 401 | 		if (base == 16) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 402 | 			size--; | 
 | 403 | 	} | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 404 |  | 
 | 405 | 	/* generate full string in tmp[], in reverse order */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 406 | 	i = 0; | 
 | 407 | 	if (num == 0) | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 408 | 		tmp[i++] = '0'; | 
| Denis Vlasenko | 4277eed | 2007-07-15 23:41:56 -0700 | [diff] [blame] | 409 | 	/* Generic code, for any base: | 
 | 410 | 	else do { | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 411 | 		tmp[i++] = (digits[do_div(num,base)] | locase); | 
| Denis Vlasenko | 4277eed | 2007-07-15 23:41:56 -0700 | [diff] [blame] | 412 | 	} while (num != 0); | 
 | 413 | 	*/ | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 414 | 	else if (base != 10) { /* 8 or 16 */ | 
 | 415 | 		int mask = base - 1; | 
 | 416 | 		int shift = 3; | 
 | 417 | 		if (base == 16) shift = 4; | 
 | 418 | 		do { | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 419 | 			tmp[i++] = (digits[((unsigned char)num) & mask] | locase); | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 420 | 			num >>= shift; | 
 | 421 | 		} while (num); | 
| Denis Vlasenko | 4277eed | 2007-07-15 23:41:56 -0700 | [diff] [blame] | 422 | 	} else { /* base 10 */ | 
 | 423 | 		i = put_dec(tmp, num) - tmp; | 
 | 424 | 	} | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 425 |  | 
 | 426 | 	/* printing 100 using %2d gives "100", not "00" */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 427 | 	if (i > precision) | 
 | 428 | 		precision = i; | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 429 | 	/* leading space padding */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 430 | 	size -= precision; | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 431 | 	if (!(type & (ZEROPAD+LEFT))) { | 
 | 432 | 		while(--size >= 0) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 433 | 			if (buf < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 434 | 				*buf = ' '; | 
 | 435 | 			++buf; | 
 | 436 | 		} | 
 | 437 | 	} | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 438 | 	/* sign */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 439 | 	if (sign) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 440 | 		if (buf < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 441 | 			*buf = sign; | 
 | 442 | 		++buf; | 
 | 443 | 	} | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 444 | 	/* "0x" / "0" prefix */ | 
 | 445 | 	if (need_pfx) { | 
 | 446 | 		if (buf < end) | 
 | 447 | 			*buf = '0'; | 
 | 448 | 		++buf; | 
 | 449 | 		if (base == 16) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 450 | 			if (buf < end) | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 451 | 				*buf = ('X' | locase); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 452 | 			++buf; | 
 | 453 | 		} | 
 | 454 | 	} | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 455 | 	/* zero or space padding */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 456 | 	if (!(type & LEFT)) { | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 457 | 		char c = (type & ZEROPAD) ? '0' : ' '; | 
 | 458 | 		while (--size >= 0) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 459 | 			if (buf < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 460 | 				*buf = c; | 
 | 461 | 			++buf; | 
 | 462 | 		} | 
 | 463 | 	} | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 464 | 	/* hmm even more zero padding? */ | 
 | 465 | 	while (i <= --precision) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 466 | 		if (buf < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 467 | 			*buf = '0'; | 
 | 468 | 		++buf; | 
 | 469 | 	} | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 470 | 	/* actual digits of result */ | 
 | 471 | 	while (--i >= 0) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 472 | 		if (buf < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 473 | 			*buf = tmp[i]; | 
 | 474 | 		++buf; | 
 | 475 | 	} | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 476 | 	/* trailing space padding */ | 
 | 477 | 	while (--size >= 0) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 478 | 		if (buf < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 479 | 			*buf = ' '; | 
 | 480 | 		++buf; | 
 | 481 | 	} | 
 | 482 | 	return buf; | 
 | 483 | } | 
 | 484 |  | 
 | 485 | /** | 
 | 486 |  * vsnprintf - Format a string and place it in a buffer | 
 | 487 |  * @buf: The buffer to place the result into | 
 | 488 |  * @size: The size of the buffer, including the trailing null space | 
 | 489 |  * @fmt: The format string to use | 
 | 490 |  * @args: Arguments for the format string | 
 | 491 |  * | 
 | 492 |  * The return value is the number of characters which would | 
 | 493 |  * be generated for the given input, excluding the trailing | 
 | 494 |  * '\0', as per ISO C99. If you want to have the exact | 
 | 495 |  * number of characters written into @buf as return value | 
| Robert P. J. Day | 72fd4a3 | 2007-02-10 01:45:59 -0800 | [diff] [blame] | 496 |  * (not including the trailing '\0'), use vscnprintf(). If the | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 497 |  * return is greater than or equal to @size, the resulting | 
 | 498 |  * string is truncated. | 
 | 499 |  * | 
 | 500 |  * Call this function if you are already dealing with a va_list. | 
| Robert P. J. Day | 72fd4a3 | 2007-02-10 01:45:59 -0800 | [diff] [blame] | 501 |  * You probably want snprintf() instead. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 502 |  */ | 
 | 503 | int vsnprintf(char *buf, size_t size, const char *fmt, va_list args) | 
 | 504 | { | 
 | 505 | 	int len; | 
 | 506 | 	unsigned long long num; | 
 | 507 | 	int i, base; | 
 | 508 | 	char *str, *end, c; | 
 | 509 | 	const char *s; | 
 | 510 |  | 
 | 511 | 	int flags;		/* flags to number() */ | 
 | 512 |  | 
 | 513 | 	int field_width;	/* width of output field */ | 
 | 514 | 	int precision;		/* min. # of digits for integers; max | 
 | 515 | 				   number of chars for from string */ | 
 | 516 | 	int qualifier;		/* 'h', 'l', or 'L' for integer fields */ | 
 | 517 | 				/* 'z' support added 23/7/1999 S.H.    */ | 
 | 518 | 				/* 'z' changed to 'Z' --davidm 1/25/99 */ | 
| Al Viro | 8032230 | 2005-08-23 22:48:17 +0100 | [diff] [blame] | 519 | 				/* 't' added for ptrdiff_t */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 520 |  | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 521 | 	/* Reject out-of-range values early.  Large positive sizes are | 
 | 522 | 	   used for unknown buffer sizes. */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 523 | 	if (unlikely((int) size < 0)) { | 
 | 524 | 		/* There can be only one.. */ | 
| Denis Vlasenko | b39a734 | 2007-07-15 23:41:54 -0700 | [diff] [blame] | 525 | 		static char warn = 1; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 526 | 		WARN_ON(warn); | 
 | 527 | 		warn = 0; | 
 | 528 | 		return 0; | 
 | 529 | 	} | 
 | 530 |  | 
 | 531 | 	str = buf; | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 532 | 	end = buf + size; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 533 |  | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 534 | 	/* Make sure end is always >= buf */ | 
 | 535 | 	if (end < buf) { | 
 | 536 | 		end = ((void *)-1); | 
 | 537 | 		size = end - buf; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 538 | 	} | 
 | 539 |  | 
 | 540 | 	for (; *fmt ; ++fmt) { | 
 | 541 | 		if (*fmt != '%') { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 542 | 			if (str < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 543 | 				*str = *fmt; | 
 | 544 | 			++str; | 
 | 545 | 			continue; | 
 | 546 | 		} | 
 | 547 |  | 
 | 548 | 		/* process flags */ | 
 | 549 | 		flags = 0; | 
 | 550 | 		repeat: | 
 | 551 | 			++fmt;		/* this also skips first '%' */ | 
 | 552 | 			switch (*fmt) { | 
 | 553 | 				case '-': flags |= LEFT; goto repeat; | 
 | 554 | 				case '+': flags |= PLUS; goto repeat; | 
 | 555 | 				case ' ': flags |= SPACE; goto repeat; | 
 | 556 | 				case '#': flags |= SPECIAL; goto repeat; | 
 | 557 | 				case '0': flags |= ZEROPAD; goto repeat; | 
 | 558 | 			} | 
 | 559 |  | 
 | 560 | 		/* get field width */ | 
 | 561 | 		field_width = -1; | 
 | 562 | 		if (isdigit(*fmt)) | 
 | 563 | 			field_width = skip_atoi(&fmt); | 
 | 564 | 		else if (*fmt == '*') { | 
 | 565 | 			++fmt; | 
 | 566 | 			/* it's the next argument */ | 
 | 567 | 			field_width = va_arg(args, int); | 
 | 568 | 			if (field_width < 0) { | 
 | 569 | 				field_width = -field_width; | 
 | 570 | 				flags |= LEFT; | 
 | 571 | 			} | 
 | 572 | 		} | 
 | 573 |  | 
 | 574 | 		/* get the precision */ | 
 | 575 | 		precision = -1; | 
 | 576 | 		if (*fmt == '.') { | 
 | 577 | 			++fmt;	 | 
 | 578 | 			if (isdigit(*fmt)) | 
 | 579 | 				precision = skip_atoi(&fmt); | 
 | 580 | 			else if (*fmt == '*') { | 
 | 581 | 				++fmt; | 
 | 582 | 				/* it's the next argument */ | 
 | 583 | 				precision = va_arg(args, int); | 
 | 584 | 			} | 
 | 585 | 			if (precision < 0) | 
 | 586 | 				precision = 0; | 
 | 587 | 		} | 
 | 588 |  | 
 | 589 | 		/* get the conversion qualifier */ | 
 | 590 | 		qualifier = -1; | 
 | 591 | 		if (*fmt == 'h' || *fmt == 'l' || *fmt == 'L' || | 
| Al Viro | 8032230 | 2005-08-23 22:48:17 +0100 | [diff] [blame] | 592 | 		    *fmt =='Z' || *fmt == 'z' || *fmt == 't') { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 593 | 			qualifier = *fmt; | 
 | 594 | 			++fmt; | 
 | 595 | 			if (qualifier == 'l' && *fmt == 'l') { | 
 | 596 | 				qualifier = 'L'; | 
 | 597 | 				++fmt; | 
 | 598 | 			} | 
 | 599 | 		} | 
 | 600 |  | 
 | 601 | 		/* default base */ | 
 | 602 | 		base = 10; | 
 | 603 |  | 
 | 604 | 		switch (*fmt) { | 
 | 605 | 			case 'c': | 
 | 606 | 				if (!(flags & LEFT)) { | 
 | 607 | 					while (--field_width > 0) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 608 | 						if (str < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 609 | 							*str = ' '; | 
 | 610 | 						++str; | 
 | 611 | 					} | 
 | 612 | 				} | 
 | 613 | 				c = (unsigned char) va_arg(args, int); | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 614 | 				if (str < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 615 | 					*str = c; | 
 | 616 | 				++str; | 
 | 617 | 				while (--field_width > 0) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 618 | 					if (str < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 619 | 						*str = ' '; | 
 | 620 | 					++str; | 
 | 621 | 				} | 
 | 622 | 				continue; | 
 | 623 |  | 
 | 624 | 			case 's': | 
 | 625 | 				s = va_arg(args, char *); | 
 | 626 | 				if ((unsigned long)s < PAGE_SIZE) | 
 | 627 | 					s = "<NULL>"; | 
 | 628 |  | 
 | 629 | 				len = strnlen(s, precision); | 
 | 630 |  | 
 | 631 | 				if (!(flags & LEFT)) { | 
 | 632 | 					while (len < field_width--) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 633 | 						if (str < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 634 | 							*str = ' '; | 
 | 635 | 						++str; | 
 | 636 | 					} | 
 | 637 | 				} | 
 | 638 | 				for (i = 0; i < len; ++i) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 639 | 					if (str < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 640 | 						*str = *s; | 
 | 641 | 					++str; ++s; | 
 | 642 | 				} | 
 | 643 | 				while (len < field_width--) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 644 | 					if (str < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 645 | 						*str = ' '; | 
 | 646 | 					++str; | 
 | 647 | 				} | 
 | 648 | 				continue; | 
 | 649 |  | 
 | 650 | 			case 'p': | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 651 | 				flags |= SMALL; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 652 | 				if (field_width == -1) { | 
 | 653 | 					field_width = 2*sizeof(void *); | 
 | 654 | 					flags |= ZEROPAD; | 
 | 655 | 				} | 
 | 656 | 				str = number(str, end, | 
 | 657 | 						(unsigned long) va_arg(args, void *), | 
 | 658 | 						16, field_width, precision, flags); | 
 | 659 | 				continue; | 
 | 660 |  | 
 | 661 |  | 
 | 662 | 			case 'n': | 
 | 663 | 				/* FIXME: | 
 | 664 | 				* What does C99 say about the overflow case here? */ | 
 | 665 | 				if (qualifier == 'l') { | 
 | 666 | 					long * ip = va_arg(args, long *); | 
 | 667 | 					*ip = (str - buf); | 
 | 668 | 				} else if (qualifier == 'Z' || qualifier == 'z') { | 
 | 669 | 					size_t * ip = va_arg(args, size_t *); | 
 | 670 | 					*ip = (str - buf); | 
 | 671 | 				} else { | 
 | 672 | 					int * ip = va_arg(args, int *); | 
 | 673 | 					*ip = (str - buf); | 
 | 674 | 				} | 
 | 675 | 				continue; | 
 | 676 |  | 
 | 677 | 			case '%': | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 678 | 				if (str < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 679 | 					*str = '%'; | 
 | 680 | 				++str; | 
 | 681 | 				continue; | 
 | 682 |  | 
 | 683 | 				/* integer number formats - set up the flags and "break" */ | 
 | 684 | 			case 'o': | 
 | 685 | 				base = 8; | 
 | 686 | 				break; | 
 | 687 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 688 | 			case 'x': | 
| Denys Vlasenko | 9b706ae | 2008-02-09 23:24:09 +0100 | [diff] [blame] | 689 | 				flags |= SMALL; | 
 | 690 | 			case 'X': | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 691 | 				base = 16; | 
 | 692 | 				break; | 
 | 693 |  | 
 | 694 | 			case 'd': | 
 | 695 | 			case 'i': | 
 | 696 | 				flags |= SIGN; | 
 | 697 | 			case 'u': | 
 | 698 | 				break; | 
 | 699 |  | 
 | 700 | 			default: | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 701 | 				if (str < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 702 | 					*str = '%'; | 
 | 703 | 				++str; | 
 | 704 | 				if (*fmt) { | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 705 | 					if (str < end) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 706 | 						*str = *fmt; | 
 | 707 | 					++str; | 
 | 708 | 				} else { | 
 | 709 | 					--fmt; | 
 | 710 | 				} | 
 | 711 | 				continue; | 
 | 712 | 		} | 
 | 713 | 		if (qualifier == 'L') | 
 | 714 | 			num = va_arg(args, long long); | 
 | 715 | 		else if (qualifier == 'l') { | 
 | 716 | 			num = va_arg(args, unsigned long); | 
 | 717 | 			if (flags & SIGN) | 
 | 718 | 				num = (signed long) num; | 
 | 719 | 		} else if (qualifier == 'Z' || qualifier == 'z') { | 
 | 720 | 			num = va_arg(args, size_t); | 
| Al Viro | 8032230 | 2005-08-23 22:48:17 +0100 | [diff] [blame] | 721 | 		} else if (qualifier == 't') { | 
 | 722 | 			num = va_arg(args, ptrdiff_t); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 723 | 		} else if (qualifier == 'h') { | 
 | 724 | 			num = (unsigned short) va_arg(args, int); | 
 | 725 | 			if (flags & SIGN) | 
 | 726 | 				num = (signed short) num; | 
 | 727 | 		} else { | 
 | 728 | 			num = va_arg(args, unsigned int); | 
 | 729 | 			if (flags & SIGN) | 
 | 730 | 				num = (signed int) num; | 
 | 731 | 		} | 
 | 732 | 		str = number(str, end, num, base, | 
 | 733 | 				field_width, precision, flags); | 
 | 734 | 	} | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 735 | 	if (size > 0) { | 
 | 736 | 		if (str < end) | 
 | 737 | 			*str = '\0'; | 
 | 738 | 		else | 
| Linus Torvalds | 0a6047e | 2006-06-28 17:09:34 -0700 | [diff] [blame] | 739 | 			end[-1] = '\0'; | 
| Jeremy Fitzhardinge | f796937 | 2006-06-25 05:49:17 -0700 | [diff] [blame] | 740 | 	} | 
 | 741 | 	/* the trailing null byte doesn't count towards the total */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 742 | 	return str-buf; | 
 | 743 | } | 
 | 744 |  | 
 | 745 | EXPORT_SYMBOL(vsnprintf); | 
 | 746 |  | 
 | 747 | /** | 
 | 748 |  * vscnprintf - Format a string and place it in a buffer | 
 | 749 |  * @buf: The buffer to place the result into | 
 | 750 |  * @size: The size of the buffer, including the trailing null space | 
 | 751 |  * @fmt: The format string to use | 
 | 752 |  * @args: Arguments for the format string | 
 | 753 |  * | 
 | 754 |  * The return value is the number of characters which have been written into | 
 | 755 |  * the @buf not including the trailing '\0'. If @size is <= 0 the function | 
 | 756 |  * returns 0. | 
 | 757 |  * | 
 | 758 |  * Call this function if you are already dealing with a va_list. | 
| Robert P. J. Day | 72fd4a3 | 2007-02-10 01:45:59 -0800 | [diff] [blame] | 759 |  * You probably want scnprintf() instead. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 760 |  */ | 
 | 761 | int vscnprintf(char *buf, size_t size, const char *fmt, va_list args) | 
 | 762 | { | 
 | 763 | 	int i; | 
 | 764 |  | 
 | 765 | 	i=vsnprintf(buf,size,fmt,args); | 
 | 766 | 	return (i >= size) ? (size - 1) : i; | 
 | 767 | } | 
 | 768 |  | 
 | 769 | EXPORT_SYMBOL(vscnprintf); | 
 | 770 |  | 
 | 771 | /** | 
 | 772 |  * snprintf - Format a string and place it in a buffer | 
 | 773 |  * @buf: The buffer to place the result into | 
 | 774 |  * @size: The size of the buffer, including the trailing null space | 
 | 775 |  * @fmt: The format string to use | 
 | 776 |  * @...: Arguments for the format string | 
 | 777 |  * | 
 | 778 |  * The return value is the number of characters which would be | 
 | 779 |  * generated for the given input, excluding the trailing null, | 
 | 780 |  * as per ISO C99.  If the return is greater than or equal to | 
 | 781 |  * @size, the resulting string is truncated. | 
 | 782 |  */ | 
 | 783 | int snprintf(char * buf, size_t size, const char *fmt, ...) | 
 | 784 | { | 
 | 785 | 	va_list args; | 
 | 786 | 	int i; | 
 | 787 |  | 
 | 788 | 	va_start(args, fmt); | 
 | 789 | 	i=vsnprintf(buf,size,fmt,args); | 
 | 790 | 	va_end(args); | 
 | 791 | 	return i; | 
 | 792 | } | 
 | 793 |  | 
 | 794 | EXPORT_SYMBOL(snprintf); | 
 | 795 |  | 
 | 796 | /** | 
 | 797 |  * scnprintf - Format a string and place it in a buffer | 
 | 798 |  * @buf: The buffer to place the result into | 
 | 799 |  * @size: The size of the buffer, including the trailing null space | 
 | 800 |  * @fmt: The format string to use | 
 | 801 |  * @...: Arguments for the format string | 
 | 802 |  * | 
 | 803 |  * The return value is the number of characters written into @buf not including | 
| Martin Peschke | ea6f328 | 2007-02-12 00:51:56 -0800 | [diff] [blame] | 804 |  * the trailing '\0'. If @size is <= 0 the function returns 0. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 805 |  */ | 
 | 806 |  | 
 | 807 | int scnprintf(char * buf, size_t size, const char *fmt, ...) | 
 | 808 | { | 
 | 809 | 	va_list args; | 
 | 810 | 	int i; | 
 | 811 |  | 
 | 812 | 	va_start(args, fmt); | 
 | 813 | 	i = vsnprintf(buf, size, fmt, args); | 
 | 814 | 	va_end(args); | 
 | 815 | 	return (i >= size) ? (size - 1) : i; | 
 | 816 | } | 
 | 817 | EXPORT_SYMBOL(scnprintf); | 
 | 818 |  | 
 | 819 | /** | 
 | 820 |  * vsprintf - Format a string and place it in a buffer | 
 | 821 |  * @buf: The buffer to place the result into | 
 | 822 |  * @fmt: The format string to use | 
 | 823 |  * @args: Arguments for the format string | 
 | 824 |  * | 
 | 825 |  * The function returns the number of characters written | 
| Robert P. J. Day | 72fd4a3 | 2007-02-10 01:45:59 -0800 | [diff] [blame] | 826 |  * into @buf. Use vsnprintf() or vscnprintf() in order to avoid | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 827 |  * buffer overflows. | 
 | 828 |  * | 
 | 829 |  * Call this function if you are already dealing with a va_list. | 
| Robert P. J. Day | 72fd4a3 | 2007-02-10 01:45:59 -0800 | [diff] [blame] | 830 |  * You probably want sprintf() instead. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 831 |  */ | 
 | 832 | int vsprintf(char *buf, const char *fmt, va_list args) | 
 | 833 | { | 
 | 834 | 	return vsnprintf(buf, INT_MAX, fmt, args); | 
 | 835 | } | 
 | 836 |  | 
 | 837 | EXPORT_SYMBOL(vsprintf); | 
 | 838 |  | 
 | 839 | /** | 
 | 840 |  * sprintf - Format a string and place it in a buffer | 
 | 841 |  * @buf: The buffer to place the result into | 
 | 842 |  * @fmt: The format string to use | 
 | 843 |  * @...: Arguments for the format string | 
 | 844 |  * | 
 | 845 |  * The function returns the number of characters written | 
| Robert P. J. Day | 72fd4a3 | 2007-02-10 01:45:59 -0800 | [diff] [blame] | 846 |  * into @buf. Use snprintf() or scnprintf() in order to avoid | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 847 |  * buffer overflows. | 
 | 848 |  */ | 
 | 849 | int sprintf(char * buf, const char *fmt, ...) | 
 | 850 | { | 
 | 851 | 	va_list args; | 
 | 852 | 	int i; | 
 | 853 |  | 
 | 854 | 	va_start(args, fmt); | 
 | 855 | 	i=vsnprintf(buf, INT_MAX, fmt, args); | 
 | 856 | 	va_end(args); | 
 | 857 | 	return i; | 
 | 858 | } | 
 | 859 |  | 
 | 860 | EXPORT_SYMBOL(sprintf); | 
 | 861 |  | 
 | 862 | /** | 
 | 863 |  * vsscanf - Unformat a buffer into a list of arguments | 
 | 864 |  * @buf:	input buffer | 
 | 865 |  * @fmt:	format of buffer | 
 | 866 |  * @args:	arguments | 
 | 867 |  */ | 
 | 868 | int vsscanf(const char * buf, const char * fmt, va_list args) | 
 | 869 | { | 
 | 870 | 	const char *str = buf; | 
 | 871 | 	char *next; | 
 | 872 | 	char digit; | 
 | 873 | 	int num = 0; | 
 | 874 | 	int qualifier; | 
 | 875 | 	int base; | 
 | 876 | 	int field_width; | 
 | 877 | 	int is_sign = 0; | 
 | 878 |  | 
 | 879 | 	while(*fmt && *str) { | 
 | 880 | 		/* skip any white space in format */ | 
 | 881 | 		/* white space in format matchs any amount of | 
 | 882 | 		 * white space, including none, in the input. | 
 | 883 | 		 */ | 
 | 884 | 		if (isspace(*fmt)) { | 
 | 885 | 			while (isspace(*fmt)) | 
 | 886 | 				++fmt; | 
 | 887 | 			while (isspace(*str)) | 
 | 888 | 				++str; | 
 | 889 | 		} | 
 | 890 |  | 
 | 891 | 		/* anything that is not a conversion must match exactly */ | 
 | 892 | 		if (*fmt != '%' && *fmt) { | 
 | 893 | 			if (*fmt++ != *str++) | 
 | 894 | 				break; | 
 | 895 | 			continue; | 
 | 896 | 		} | 
 | 897 |  | 
 | 898 | 		if (!*fmt) | 
 | 899 | 			break; | 
 | 900 | 		++fmt; | 
 | 901 | 		 | 
 | 902 | 		/* skip this conversion. | 
 | 903 | 		 * advance both strings to next white space | 
 | 904 | 		 */ | 
 | 905 | 		if (*fmt == '*') { | 
 | 906 | 			while (!isspace(*fmt) && *fmt) | 
 | 907 | 				fmt++; | 
 | 908 | 			while (!isspace(*str) && *str) | 
 | 909 | 				str++; | 
 | 910 | 			continue; | 
 | 911 | 		} | 
 | 912 |  | 
 | 913 | 		/* get field width */ | 
 | 914 | 		field_width = -1; | 
 | 915 | 		if (isdigit(*fmt)) | 
 | 916 | 			field_width = skip_atoi(&fmt); | 
 | 917 |  | 
 | 918 | 		/* get conversion qualifier */ | 
 | 919 | 		qualifier = -1; | 
 | 920 | 		if (*fmt == 'h' || *fmt == 'l' || *fmt == 'L' || | 
 | 921 | 		    *fmt == 'Z' || *fmt == 'z') { | 
 | 922 | 			qualifier = *fmt++; | 
 | 923 | 			if (unlikely(qualifier == *fmt)) { | 
 | 924 | 				if (qualifier == 'h') { | 
 | 925 | 					qualifier = 'H'; | 
 | 926 | 					fmt++; | 
 | 927 | 				} else if (qualifier == 'l') { | 
 | 928 | 					qualifier = 'L'; | 
 | 929 | 					fmt++; | 
 | 930 | 				} | 
 | 931 | 			} | 
 | 932 | 		} | 
 | 933 | 		base = 10; | 
 | 934 | 		is_sign = 0; | 
 | 935 |  | 
 | 936 | 		if (!*fmt || !*str) | 
 | 937 | 			break; | 
 | 938 |  | 
 | 939 | 		switch(*fmt++) { | 
 | 940 | 		case 'c': | 
 | 941 | 		{ | 
 | 942 | 			char *s = (char *) va_arg(args,char*); | 
 | 943 | 			if (field_width == -1) | 
 | 944 | 				field_width = 1; | 
 | 945 | 			do { | 
 | 946 | 				*s++ = *str++; | 
 | 947 | 			} while (--field_width > 0 && *str); | 
 | 948 | 			num++; | 
 | 949 | 		} | 
 | 950 | 		continue; | 
 | 951 | 		case 's': | 
 | 952 | 		{ | 
 | 953 | 			char *s = (char *) va_arg(args, char *); | 
 | 954 | 			if(field_width == -1) | 
 | 955 | 				field_width = INT_MAX; | 
 | 956 | 			/* first, skip leading white space in buffer */ | 
 | 957 | 			while (isspace(*str)) | 
 | 958 | 				str++; | 
 | 959 |  | 
 | 960 | 			/* now copy until next white space */ | 
 | 961 | 			while (*str && !isspace(*str) && field_width--) { | 
 | 962 | 				*s++ = *str++; | 
 | 963 | 			} | 
 | 964 | 			*s = '\0'; | 
 | 965 | 			num++; | 
 | 966 | 		} | 
 | 967 | 		continue; | 
 | 968 | 		case 'n': | 
 | 969 | 			/* return number of characters read so far */ | 
 | 970 | 		{ | 
 | 971 | 			int *i = (int *)va_arg(args,int*); | 
 | 972 | 			*i = str - buf; | 
 | 973 | 		} | 
 | 974 | 		continue; | 
 | 975 | 		case 'o': | 
 | 976 | 			base = 8; | 
 | 977 | 			break; | 
 | 978 | 		case 'x': | 
 | 979 | 		case 'X': | 
 | 980 | 			base = 16; | 
 | 981 | 			break; | 
 | 982 | 		case 'i': | 
 | 983 |                         base = 0; | 
 | 984 | 		case 'd': | 
 | 985 | 			is_sign = 1; | 
 | 986 | 		case 'u': | 
 | 987 | 			break; | 
 | 988 | 		case '%': | 
 | 989 | 			/* looking for '%' in str */ | 
 | 990 | 			if (*str++ != '%')  | 
 | 991 | 				return num; | 
 | 992 | 			continue; | 
 | 993 | 		default: | 
 | 994 | 			/* invalid format; stop here */ | 
 | 995 | 			return num; | 
 | 996 | 		} | 
 | 997 |  | 
 | 998 | 		/* have some sort of integer conversion. | 
 | 999 | 		 * first, skip white space in buffer. | 
 | 1000 | 		 */ | 
 | 1001 | 		while (isspace(*str)) | 
 | 1002 | 			str++; | 
 | 1003 |  | 
 | 1004 | 		digit = *str; | 
 | 1005 | 		if (is_sign && digit == '-') | 
 | 1006 | 			digit = *(str + 1); | 
 | 1007 |  | 
 | 1008 | 		if (!digit | 
 | 1009 |                     || (base == 16 && !isxdigit(digit)) | 
 | 1010 |                     || (base == 10 && !isdigit(digit)) | 
 | 1011 |                     || (base == 8 && (!isdigit(digit) || digit > '7')) | 
 | 1012 |                     || (base == 0 && !isdigit(digit))) | 
 | 1013 | 				break; | 
 | 1014 |  | 
 | 1015 | 		switch(qualifier) { | 
 | 1016 | 		case 'H':	/* that's 'hh' in format */ | 
 | 1017 | 			if (is_sign) { | 
 | 1018 | 				signed char *s = (signed char *) va_arg(args,signed char *); | 
 | 1019 | 				*s = (signed char) simple_strtol(str,&next,base); | 
 | 1020 | 			} else { | 
 | 1021 | 				unsigned char *s = (unsigned char *) va_arg(args, unsigned char *); | 
 | 1022 | 				*s = (unsigned char) simple_strtoul(str, &next, base); | 
 | 1023 | 			} | 
 | 1024 | 			break; | 
 | 1025 | 		case 'h': | 
 | 1026 | 			if (is_sign) { | 
 | 1027 | 				short *s = (short *) va_arg(args,short *); | 
 | 1028 | 				*s = (short) simple_strtol(str,&next,base); | 
 | 1029 | 			} else { | 
 | 1030 | 				unsigned short *s = (unsigned short *) va_arg(args, unsigned short *); | 
 | 1031 | 				*s = (unsigned short) simple_strtoul(str, &next, base); | 
 | 1032 | 			} | 
 | 1033 | 			break; | 
 | 1034 | 		case 'l': | 
 | 1035 | 			if (is_sign) { | 
 | 1036 | 				long *l = (long *) va_arg(args,long *); | 
 | 1037 | 				*l = simple_strtol(str,&next,base); | 
 | 1038 | 			} else { | 
 | 1039 | 				unsigned long *l = (unsigned long*) va_arg(args,unsigned long*); | 
 | 1040 | 				*l = simple_strtoul(str,&next,base); | 
 | 1041 | 			} | 
 | 1042 | 			break; | 
 | 1043 | 		case 'L': | 
 | 1044 | 			if (is_sign) { | 
 | 1045 | 				long long *l = (long long*) va_arg(args,long long *); | 
 | 1046 | 				*l = simple_strtoll(str,&next,base); | 
 | 1047 | 			} else { | 
 | 1048 | 				unsigned long long *l = (unsigned long long*) va_arg(args,unsigned long long*); | 
 | 1049 | 				*l = simple_strtoull(str,&next,base); | 
 | 1050 | 			} | 
 | 1051 | 			break; | 
 | 1052 | 		case 'Z': | 
 | 1053 | 		case 'z': | 
 | 1054 | 		{ | 
 | 1055 | 			size_t *s = (size_t*) va_arg(args,size_t*); | 
 | 1056 | 			*s = (size_t) simple_strtoul(str,&next,base); | 
 | 1057 | 		} | 
 | 1058 | 		break; | 
 | 1059 | 		default: | 
 | 1060 | 			if (is_sign) { | 
 | 1061 | 				int *i = (int *) va_arg(args, int*); | 
 | 1062 | 				*i = (int) simple_strtol(str,&next,base); | 
 | 1063 | 			} else { | 
 | 1064 | 				unsigned int *i = (unsigned int*) va_arg(args, unsigned int*); | 
 | 1065 | 				*i = (unsigned int) simple_strtoul(str,&next,base); | 
 | 1066 | 			} | 
 | 1067 | 			break; | 
 | 1068 | 		} | 
 | 1069 | 		num++; | 
 | 1070 |  | 
 | 1071 | 		if (!next) | 
 | 1072 | 			break; | 
 | 1073 | 		str = next; | 
 | 1074 | 	} | 
| Johannes Berg | c6b40d1 | 2007-05-08 00:27:20 -0700 | [diff] [blame] | 1075 |  | 
 | 1076 | 	/* | 
 | 1077 | 	 * Now we've come all the way through so either the input string or the | 
 | 1078 | 	 * format ended. In the former case, there can be a %n at the current | 
 | 1079 | 	 * position in the format that needs to be filled. | 
 | 1080 | 	 */ | 
 | 1081 | 	if (*fmt == '%' && *(fmt + 1) == 'n') { | 
 | 1082 | 		int *p = (int *)va_arg(args, int *); | 
 | 1083 | 		*p = str - buf; | 
 | 1084 | 	} | 
 | 1085 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1086 | 	return num; | 
 | 1087 | } | 
 | 1088 |  | 
 | 1089 | EXPORT_SYMBOL(vsscanf); | 
 | 1090 |  | 
 | 1091 | /** | 
 | 1092 |  * sscanf - Unformat a buffer into a list of arguments | 
 | 1093 |  * @buf:	input buffer | 
 | 1094 |  * @fmt:	formatting of buffer | 
 | 1095 |  * @...:	resulting arguments | 
 | 1096 |  */ | 
 | 1097 | int sscanf(const char * buf, const char * fmt, ...) | 
 | 1098 | { | 
 | 1099 | 	va_list args; | 
 | 1100 | 	int i; | 
 | 1101 |  | 
 | 1102 | 	va_start(args,fmt); | 
 | 1103 | 	i = vsscanf(buf,fmt,args); | 
 | 1104 | 	va_end(args); | 
 | 1105 | 	return i; | 
 | 1106 | } | 
 | 1107 |  | 
 | 1108 | EXPORT_SYMBOL(sscanf); |