diff --git a/lib/libc/sys/kenv.2 b/lib/libc/sys/kenv.2 index cbda2168c857..9d8bd327cc5a 100644 --- a/lib/libc/sys/kenv.2 +++ b/lib/libc/sys/kenv.2 @@ -1,5 +1,5 @@ .\" -.\" Copyright (C) 2001 Chad David . All rights reserved. +.\" Copyright (C) 2002 Chad David . All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions @@ -49,10 +49,11 @@ the kernel environment. The .Fa action parameter can be one of the following: -.Bl -tag -width ".Dv KENV_DUMP" +.Bl -tag -width ".Dv KENV_UNSET" .It Dv KENV_GET Returns the value associated with the named kernel environment variable. -If the variable is not found -1 is returned and +If the variable is not found, \-1 is returned and +the global variable .Va errno is set to .Er ENOENT . @@ -61,11 +62,12 @@ Only the number of bytes available in are copied out. .It Dv KENV_SET Sets or adds a new kernel environment variable. -This option is only avaiable to the superuser. +This option is only available to the superuser. .It Dv KENV_UNSET Unsets the kernel environment variable .Fa name . -If the variable does not exists -1 is returned and +If the variable does not exist, \-1 is returned and +the global variable .Va errno is set to .Er EINVAL . @@ -100,7 +102,7 @@ should copy return data to in the case of .Dv KENV_DUMP and .Dv KENV_GET . -If +If .Fa value is .Dv NULL @@ -120,14 +122,15 @@ The function returns 0 if successful in the case of .Dv KENV_SET and -.Dv KENV_UNSET, +.Dv KENV_UNSET , and the number of bytes copied into .Fa value in the case of .Dv KENV_DUMP and .Dv KENV_GET . -If an error occurs, a value of -1 is returned and +If an error occurs, a value of \-1 is returned and +the global variable .Va errno is set to indicate the error. .Sh ERRORS @@ -148,10 +151,10 @@ for a or .Dv KENV_UNSET . .It Bq Er EPERM -a user other than the superuser attempted to set or unset an kernel +a user other than the superuser attempted to set or unset a kernel environment variable. .It Bq Er EFAULT -a bad address was encountered while attempting to copy in user arguments, +bad address was encountered while attempting to copy in user arguments, or copy out value(s). .It Bq Er ENAMETOOLONG the name of a variable supplied by the user is longer than @@ -166,7 +169,7 @@ or the value of a variable is longer than This man page was written by .An Chad David Aq davidc@FreeBSD.org . .Pp -The +The .Fn kenv system call was written by .An Maxime Henrion Aq mux@FreeBSD.org .