1 files changed, 163 insertions, 0 deletions
diff --git a/src/lib/libc/stdlib/strtoul.3 b/src/lib/libc/stdlib/strtoul.3
new file mode 100644
index 0000000000..b8234122a2
--- /dev/null
+++ b/src/lib/libc/stdlib/strtoul.3
@@ -0,0 +1,163 @@
+.\" Copyright (c) 1990, 1991 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to Berkeley by
+.\" Chris Torek and the American National Standards Committee X3,
+.\" on Information Processing Systems.
+.\"
+.\" 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.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"     This product includes software developed by the University of
+.\"     California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``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 REGENTS OR CONTRIBUTORS 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.
+.\"
+.\"     $OpenBSD: strtoul.3,v 1.2 1996/08/19 08:33:52 tholo Exp $
+.\"
+.Dd June 25, 1992
+.Dt STRTOUL 3
+.Os
+.Sh NAME
+.Nm strtoul, strtouq
+.Nd convert a string to an unsigned long or uquad_t integer
+.Sh SYNOPSIS
+.Fd #include <stdlib.h>
+.Fd #include <limits.h>
+.Ft unsigned long
+.Fn strtoul "const char *nptr" "char **endptr" "int base"
+.Fd #include <sys/types.h>
+.Fd #include <stdlib.h>
+.Fd #include <limits.h>
+.Ft u_quad_t
+.Fn strtouq "const char *nptr" "char **endptr" "int base"
+.Sh DESCRIPTION
+The
+.Fn strtoul
+function
+converts the string in
+.Fa nptr
+to an
+.Em unsigned long
+value.
+The
+.Fn strtouq
+function
+converts the string in
+.Fa nptr
+to a
+.Em u_quad_t
+value.
+The conversion is done according to the given
+.Fa base ,
+which must be between 2 and 36 inclusive,
+or be the special value 0.
+.Pp
+The string may begin with an arbitrary amount of white space
+(as determined by
+.Xr isspace 3 )
+followed by a single optional
+.Ql +
+or
+.Ql -
+sign.
+If
+.Fa base
+is zero or 16,
+the string may then include a
+.Ql 0x
+prefix,
+and the number will be read in base 16; otherwise, a zero
+.Fa base
+is taken as 10 (decimal) unless the next character is
+.Ql 0 ,
+in which case it is taken as 8 (octal).
+.Pp
+The remainder of the string is converted to an
+.Em unsigned long
+value in the obvious manner,
+stopping at the end of the string
+or at the first character that does not produce a valid digit
+in the given base.
+(In bases above 10, the letter
+.Ql A
+in either upper or lower case
+represents 10,
+.Ql B
+represents 11, and so forth, with
+.Ql Z
+representing 35.)
+.Pp
+If
+.Fa endptr
+is non nil,
+.Fn strtoul
+stores the address of the first invalid character in
+.Fa *endptr .
+If there were no digits at all, however,
+.Fn strtoul
+stores the original value of
+.Fa nptr
+in
+.Fa *endptr .
+(Thus, if
+.Fa *nptr
+is not
+.Ql \e0
+but
+.Fa **endptr
+is
+.Ql \e0
+on return, the entire string was valid.)
+.Sh RETURN VALUES
+The
+.Fn strtoul
+function
+returns either the result of the conversion
+or, if there was a leading minus sign,
+the negation of the result of the conversion,
+unless the original (non-negated) value would overflow;
+in the latter case,
+.Fn strtoul
+returns
+.Dv ULONG_MAX
+and sets the global variable
+.Va errno
+to
+.Er ERANGE .
+.Sh ERRORS
+.Bl -tag -width Er
+.It Bq Er ERANGE
+The given string was out of range; the value converted has been clamped.
+.El
+.Sh SEE ALSO
+.Xr strtol 3
+.Sh STANDARDS
+The
+.Fn strtoul
+function
+conforms to
+.St -ansiC .
+.Sh BUGS
+Ignores the current locale.

diff --git a/src/lib/libc/stdlib/strtoul.3 b/src/lib/libc/stdlib/strtoul.3 new file mode 100644 index 0000000000..b8234122a2 --- /dev/null +++ b/src/lib/libc/stdlib/strtoul.3
@@ -0,0 +1,163 @@
	1	.\" Copyright (c) 1990, 1991 The Regents of the University of California.
	2	.\" All rights reserved.
	3	.\"
	4	.\" This code is derived from software contributed to Berkeley by
	5	.\" Chris Torek and the American National Standards Committee X3,
	6	.\" on Information Processing Systems.
	7	.\"
	8	.\" Redistribution and use in source and binary forms, with or without
	9	.\" modification, are permitted provided that the following conditions
	10	.\" are met:
	11	.\" 1. Redistributions of source code must retain the above copyright
	12	.\" notice, this list of conditions and the following disclaimer.
	13	.\" 2. Redistributions in binary form must reproduce the above copyright
	14	.\" notice, this list of conditions and the following disclaimer in the
	15	.\" documentation and/or other materials provided with the distribution.
	16	.\" 3. All advertising materials mentioning features or use of this software
	17	.\" must display the following acknowledgement:
	18	.\" This product includes software developed by the University of
	19	.\" California, Berkeley and its contributors.
	20	.\" 4. Neither the name of the University nor the names of its contributors
	21	.\" may be used to endorse or promote products derived from this software
	22	.\" without specific prior written permission.
	23	.\"
	24	.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
	25	.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
	26	.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
	27	.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
	28	.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	29	.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
	30	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	31	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	32	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	33	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	34	.\" SUCH DAMAGE.
	35	.\"
	36	.\" $OpenBSD: strtoul.3,v 1.2 1996/08/19 08:33:52 tholo Exp $
	37	.\"
	38	.Dd June 25, 1992
	39	.Dt STRTOUL 3
	40	.Os
	41	.Sh NAME
	42	.Nm strtoul, strtouq
	43	.Nd convert a string to an unsigned long or uquad_t integer
	44	.Sh SYNOPSIS
	45	.Fd #include <stdlib.h>
	46	.Fd #include <limits.h>
	47	.Ft unsigned long
	48	.Fn strtoul "const char nptr" "char *endptr" "int base"
	49
	50	.Fd #include <sys/types.h>
	51	.Fd #include <stdlib.h>
	52	.Fd #include <limits.h>
	53	.Ft u_quad_t
	54	.Fn strtouq "const char nptr" "char *endptr" "int base"
	55	.Sh DESCRIPTION
	56	The
	57	.Fn strtoul
	58	function
	59	converts the string in
	60	.Fa nptr
	61	to an
	62	.Em unsigned long
	63	value.
	64	The
	65	.Fn strtouq
	66	function
	67	converts the string in
	68	.Fa nptr
	69	to a
	70	.Em u_quad_t
	71	value.
	72	The conversion is done according to the given
	73	.Fa base ,
	74	which must be between 2 and 36 inclusive,
	75	or be the special value 0.
	76	.Pp
	77	The string may begin with an arbitrary amount of white space
	78	(as determined by
	79	.Xr isspace 3 )
	80	followed by a single optional
	81	.Ql +
	82	or
	83	.Ql -
	84	sign.
	85	If
	86	.Fa base
	87	is zero or 16,
	88	the string may then include a
	89	.Ql 0x
	90	prefix,
	91	and the number will be read in base 16; otherwise, a zero
	92	.Fa base
	93	is taken as 10 (decimal) unless the next character is
	94	.Ql 0 ,
	95	in which case it is taken as 8 (octal).
	96	.Pp
	97	The remainder of the string is converted to an
	98	.Em unsigned long
	99	value in the obvious manner,
	100	stopping at the end of the string
	101	or at the first character that does not produce a valid digit
	102	in the given base.
	103	(In bases above 10, the letter
	104	.Ql A
	105	in either upper or lower case
	106	represents 10,
	107	.Ql B
	108	represents 11, and so forth, with
	109	.Ql Z
	110	representing 35.)
	111	.Pp
	112	If
	113	.Fa endptr
	114	is non nil,
	115	.Fn strtoul
	116	stores the address of the first invalid character in
	117	.Fa *endptr .
	118	If there were no digits at all, however,
	119	.Fn strtoul
	120	stores the original value of
	121	.Fa nptr
	122	in
	123	.Fa *endptr .
	124	(Thus, if
	125	.Fa *nptr
	126	is not
	127	.Ql \e0
	128	but
	129	.Fa **endptr
	130	is
	131	.Ql \e0
	132	on return, the entire string was valid.)
	133	.Sh RETURN VALUES
	134	The
	135	.Fn strtoul
	136	function
	137	returns either the result of the conversion
	138	or, if there was a leading minus sign,
	139	the negation of the result of the conversion,
	140	unless the original (non-negated) value would overflow;
	141	in the latter case,
	142	.Fn strtoul
	143	returns
	144	.Dv ULONG_MAX
	145	and sets the global variable
	146	.Va errno
	147	to
	148	.Er ERANGE .
	149	.Sh ERRORS
	150	.Bl -tag -width Er
	151	.It Bq Er ERANGE
	152	The given string was out of range; the value converted has been clamped.
	153	.El
	154	.Sh SEE ALSO
	155	.Xr strtol 3
	156	.Sh STANDARDS
	157	The
	158	.Fn strtoul
	159	function
	160	conforms to
	161	.St -ansiC .
	162	.Sh BUGS
	163	Ignores the current locale.