diff options
author | Gordon Bergling <gbe@FreeBSD.org> | 2020-10-09 19:12:44 +0000 |
---|---|---|
committer | Gordon Bergling <gbe@FreeBSD.org> | 2020-10-09 19:12:44 +0000 |
commit | 3d265fce43746c293ae826e9603adbfe09f93cf6 (patch) | |
tree | 595842fb2fed2701f1313532154050161a314090 /lib | |
parent | eb88fed44616747f930b74c42259511823811fe1 (diff) | |
download | src-test2-3d265fce43746c293ae826e9603adbfe09f93cf6.tar.gz src-test2-3d265fce43746c293ae826e9603adbfe09f93cf6.zip |
Notes
Diffstat (limited to 'lib')
-rw-r--r-- | lib/libc/capability/cap_rights_init.3 | 2 | ||||
-rw-r--r-- | lib/libc/sys/cpuset_getaffinity.2 | 2 | ||||
-rw-r--r-- | lib/libc/sys/cpuset_getdomain.2 | 5 | ||||
-rw-r--r-- | lib/libc/sys/fhlink.2 | 2 | ||||
-rw-r--r-- | lib/libc/sys/getitimer.2 | 2 | ||||
-rw-r--r-- | lib/libc/sys/getsockopt.2 | 5 | ||||
-rw-r--r-- | lib/libgssapi/gss_accept_sec_context.3 | 22 | ||||
-rw-r--r-- | lib/libmd/mdX.3 | 2 | ||||
-rw-r--r-- | lib/libmd/ripemd.3 | 2 | ||||
-rw-r--r-- | lib/libmd/sha.3 | 2 | ||||
-rw-r--r-- | lib/libmd/sha256.3 | 2 | ||||
-rw-r--r-- | lib/libmd/sha512.3 | 2 | ||||
-rw-r--r-- | lib/libmd/skein.3 | 10 | ||||
-rw-r--r-- | lib/libmt/mt.3 | 22 | ||||
-rw-r--r-- | lib/libpathconv/abs2rel.3 | 4 | ||||
-rw-r--r-- | lib/libpmc/pmc.sandybridge.3 | 2 | ||||
-rw-r--r-- | lib/libpmc/pmc.sandybridgeuc.3 | 2 | ||||
-rw-r--r-- | lib/libradius/libradius.3 | 9 | ||||
-rw-r--r-- | lib/librpcsec_gss/rpc_gss_set_callback.3 | 3 | ||||
-rw-r--r-- | lib/libsysdecode/sysdecode_mask.3 | 6 | ||||
-rw-r--r-- | lib/libusb/libusb20.3 | 35 | ||||
-rw-r--r-- | lib/libutil/login_ok.3 | 2 | ||||
-rw-r--r-- | lib/msun/man/sincos.3 | 20 |
23 files changed, 87 insertions, 78 deletions
diff --git a/lib/libc/capability/cap_rights_init.3 b/lib/libc/capability/cap_rights_init.3 index 95c62dc1636c..9695a188e317 100644 --- a/lib/libc/capability/cap_rights_init.3 +++ b/lib/libc/capability/cap_rights_init.3 @@ -239,7 +239,7 @@ The functions .Fn cap_rights_is_set , .Fn cap_rights_is_valid , .Fn cap_rights_merge , -.Fn cap_rights_remove +.Fn cap_rights_remove and .Fn cap_rights_contains first appeared in diff --git a/lib/libc/sys/cpuset_getaffinity.2 b/lib/libc/sys/cpuset_getaffinity.2 index ebc72e391ed2..49a7d466d331 100644 --- a/lib/libc/sys/cpuset_getaffinity.2 +++ b/lib/libc/sys/cpuset_getaffinity.2 @@ -149,7 +149,7 @@ was either preposterously large or smaller than the kernel set size. The calling process did not have the credentials required to complete the operation. .It Bq Er ECAPMODE -The calling process attempted to act on a process other than itself, while +The calling process attempted to act on a process other than itself, while in capability mode. See .Xr capsicum 4 . diff --git a/lib/libc/sys/cpuset_getdomain.2 b/lib/libc/sys/cpuset_getdomain.2 index 399b4bed93b2..919b79ada684 100644 --- a/lib/libc/sys/cpuset_getdomain.2 +++ b/lib/libc/sys/cpuset_getdomain.2 @@ -119,7 +119,8 @@ Memory is allocated on a round-robin basis by cycling through each domain in .Fa mask . .It Dv DOMAINSET_POLICY_FIRSTTOUCH Memory is allocated on the domain local to the CPU the requesting thread is -running on. Failure to allocate from this domain will fallback to round-robin. +running on. +Failure to allocate from this domain will fallback to round-robin. .It Dv DOMAINSET_POLICY_PREFER Memory is allocated preferentially from the single domain specified in the mask. If memory is unavailable the domains listed in the parent cpuset will be @@ -167,7 +168,7 @@ was either preposterously large or smaller than the kernel set size. The calling process did not have the credentials required to complete the operation. .It Bq Er ECAPMODE -The calling process attempted to act on a process other than itself, while +The calling process attempted to act on a process other than itself, while in capability mode. See .Xr capsicum 4 . diff --git a/lib/libc/sys/fhlink.2 b/lib/libc/sys/fhlink.2 index 1fcb7365fc0c..0cf00de84b4b 100644 --- a/lib/libc/sys/fhlink.2 +++ b/lib/libc/sys/fhlink.2 @@ -178,7 +178,7 @@ The link count of the file pointed at by .Fa fhp would exceed 32767. .It Bq Er EACCES -A component of +A component of .Fa to prefix denies search permission. .It Bq Er EACCES diff --git a/lib/libc/sys/getitimer.2 b/lib/libc/sys/getitimer.2 index 9f8df6dbf7c0..1cb3d5e6a6b2 100644 --- a/lib/libc/sys/getitimer.2 +++ b/lib/libc/sys/getitimer.2 @@ -28,7 +28,7 @@ .\" @(#)getitimer.2 8.3 (Berkeley) 5/16/95 .\" $FreeBSD$ .\" -.Dd May 1, 2020 +.Dd May 1, 2020 .Dt GETITIMER 2 .Os .Sh NAME diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2 index dcd39e07efb8..1e4ed6827170 100644 --- a/lib/libc/sys/getsockopt.2 +++ b/lib/libc/sys/getsockopt.2 @@ -28,7 +28,7 @@ .\" @(#)getsockopt.2 8.4 (Berkeley) 5/2/95 .\" $FreeBSD$ .\" -.Dd June 03, 2020 +.Dd June 3, 2020 .Dt GETSOCKOPT 2 .Os .Sh NAME @@ -219,7 +219,8 @@ if they all set before binding the port. Incoming TCP and UDP connections are distributed among the sharing processes based on a hash function of local port number, foreign IP -address and port number. A maximum of 256 processes can share one socket. +address and port number. +A maximum of 256 processes can share one socket. .Pp .Dv SO_KEEPALIVE enables the diff --git a/lib/libgssapi/gss_accept_sec_context.3 b/lib/libgssapi/gss_accept_sec_context.3 index cc368876e390..5d132eff1de4 100644 --- a/lib/libgssapi/gss_accept_sec_context.3 +++ b/lib/libgssapi/gss_accept_sec_context.3 @@ -52,8 +52,9 @@ .Fa "gss_cred_id_t *delegated_cred_handle" .Fc .Sh DESCRIPTION -Allows a remotely initiated security context between the application -and a remote peer to be established. The routine may return a +Allows a remotely initiated security context between the application and a remote +peer to be established. +The routine may return a .Fa output_token which should be transferred to the peer application, where the peer application will present it to @@ -78,7 +79,8 @@ parameters. .Pp Portable applications should be constructed to use the token length and return status to determine whether a token needs to be sent or -waited for. Thus a typical portable caller should always invoke +waited for. +Thus a typical portable caller should always invoke .Fn gss_accept_sec_context within a loop: .Bd -literal @@ -166,10 +168,9 @@ returned to a caller (i.e. when accompanied by a .Dv GSS_S_COMPLETE status code), applications -should not rely on this behavior as the flag was not defined in -Version 1 of the GSS-API. Instead, applications should be prepared to -use per-message services after a successful context establishment, -according to the +should not rely on this behavior as the flag was not defined in Version 1 of the GSS-API. +Instead, applications should be prepared to use per-message services after a +successful context establishment, according to the .Dv GSS_C_INTEG_FLAG and .Dv GSS_C_CONF_FLAG values. @@ -190,9 +191,10 @@ fails, the implementation should not create a context object, and should leave the value of the context_handle parameter set to .Dv GSS_C_NO_CONTEXT to -indicate this. In the event of a failure on a subsequent call, the -implementation is permitted to delete the "half-built" security -context (in which case it should set the +indicate this. +In the event of a failure on a subsequent call, the implementation is +permitted to delete the "half-built" security context (in which case it +should set the .Fa context_handle parameter to .Dv GSS_C_NO_CONTEXT ), but the preferred behavior is to leave the diff --git a/lib/libmd/mdX.3 b/lib/libmd/mdX.3 index b5f4fc07c9b7..30e6f367c662 100644 --- a/lib/libmd/mdX.3 +++ b/lib/libmd/mdX.3 @@ -157,7 +157,7 @@ The .Fn MDXFile and .Fn MDXFileChunk -may return NULL when underlying +may return NULL when underlying .Xr open 2 , .Xr fstat 2 , .Xr lseek 2 , diff --git a/lib/libmd/ripemd.3 b/lib/libmd/ripemd.3 index 54cdf73ecc8d..d868ae12827b 100644 --- a/lib/libmd/ripemd.3 +++ b/lib/libmd/ripemd.3 @@ -137,7 +137,7 @@ The .Fn RIPEMD160_File and .Fn RIPEMD160_FileChunk -may return NULL when underlying +may return NULL when underlying .Xr open 2 , .Xr fstat 2 , .Xr lseek 2 , diff --git a/lib/libmd/sha.3 b/lib/libmd/sha.3 index ac8e3ae02511..20a1e5639dde 100644 --- a/lib/libmd/sha.3 +++ b/lib/libmd/sha.3 @@ -168,7 +168,7 @@ The .Fn SHA1_File and .Fn SHA1_FileChunk -may return NULL when underlying +may return NULL when underlying .Xr open 2 , .Xr fstat 2 , .Xr lseek 2 , diff --git a/lib/libmd/sha256.3 b/lib/libmd/sha256.3 index a6829a5ed2ea..d11f2f783557 100644 --- a/lib/libmd/sha256.3 +++ b/lib/libmd/sha256.3 @@ -159,7 +159,7 @@ The .Fn SHA256_File and .Fn SHA256_FileChunk -may return NULL when underlying +may return NULL when underlying .Xr open 2 , .Xr fstat 2 , .Xr lseek 2 , diff --git a/lib/libmd/sha512.3 b/lib/libmd/sha512.3 index 64981e64310c..6a5ed6f887d9 100644 --- a/lib/libmd/sha512.3 +++ b/lib/libmd/sha512.3 @@ -203,7 +203,7 @@ The .Fn SHA512_File and .Fn SHA512_FileChunk -may return NULL when underlying +may return NULL when underlying .Xr open 2 , .Xr fstat 2 , .Xr lseek 2 , diff --git a/lib/libmd/skein.3 b/lib/libmd/skein.3 index b0278028b1bc..325a1ab4874b 100644 --- a/lib/libmd/skein.3 +++ b/lib/libmd/skein.3 @@ -201,7 +201,7 @@ The .Fn SKEIN256_File and .Fn SKEIN256_FileChunk -may return NULL when underlying +may return NULL when underlying .Xr open 2 , .Xr fstat 2 , .Xr lseek 2 , @@ -220,15 +220,15 @@ These functions appeared in .Fx 11.0 . .Sh AUTHORS .An -nosplit -The core hash routines were imported from version 1.3 of the optimized +The core hash routines were imported from version 1.3 of the optimized Skein reference implementation written by .An Doug Whiting as submitted to the NSA SHA-3 contest. The algorithms were developed by -.An Niels Ferguson , +.An Niels Ferguson , .An Stefan Lucks , -.An Bruce Schneier , -.An Doug Whiting , +.An Bruce Schneier , +.An Doug Whiting , .An Mihir Bellare , .An Tadayoshi Kohno , .An Jon Callas, diff --git a/lib/libmt/mt.3 b/lib/libmt/mt.3 index 39a4d658a590..cadb1689a8d4 100644 --- a/lib/libmt/mt.3 +++ b/lib/libmt/mt.3 @@ -1,7 +1,7 @@ -.\" +.\" .\" Copyright (c) 2013, 2015 Spectra Logic Corporation .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -13,7 +13,7 @@ .\" ("Disclaimer") and any redistribution must be conditioned upon .\" including a substantially similar Disclaimer requirement for further .\" binary redistribution. -.\" +.\" .\" NO WARRANTY .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT @@ -26,9 +26,9 @@ .\" 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 DAMAGES. -.\" +.\" .\" Authors: Ken Merry (Spectra Logic Corporation) -.\" +.\" .\" $FreeBSD$ .\" .Dd February 13, 2015 @@ -177,7 +177,7 @@ driver returns some status data as XML-formatted strings, and the primary purpose of this library is to make it easier for the software developer to parse those strings and extract the status values. .Pp -The +The .Fn mt_start_element , .Fn mt_end_element , and @@ -310,7 +310,7 @@ except that it prints the results to standard output instead of an sbuf. .Pp .Fn mt_param_entry_sbuf prints the -.Ar entry +.Ar entry to the given sbuf .Ar sb . The argument @@ -361,7 +361,7 @@ See below for notes on the return values. Returns the bits per inch or bits per mm values for a given density entry specified by the .Ar density_num . -If the +If the .Ar bpi argument is non-zero, the bits per inch value is returned. Otherwise, the bits per mm value is returned. @@ -375,8 +375,8 @@ to the supplied density name. gets the current XML status / parameter string from the sa(4) driver instance referenced by the open file descriptor .Ar mtfd . -The -.Xr mtio 4 +The +.Xr mtio 4 .Xr ioctl 2 to be used is supplied as the .Ar cmd @@ -425,7 +425,7 @@ If the density is not known, will return "UNKNOWN". .Pp .Fn mt_density_bp -returns the bits per inch value for the given density (if the +returns the bits per inch value for the given density (if the .Ar bpi field is non-zero), the bits per mm value otherwise, or 0 if the supplied .Ar density_num diff --git a/lib/libpathconv/abs2rel.3 b/lib/libpathconv/abs2rel.3 index 4d46d8a79b26..984b2530e1b0 100644 --- a/lib/libpathconv/abs2rel.3 +++ b/lib/libpathconv/abs2rel.3 @@ -119,8 +119,8 @@ yields: path == "../../../sys/kern" /* It's correct but ... */ -That is correct, but a little redundant. If you wish get the simple -answer 'kern', do the following. +That is correct, but a little redundant. +If you wish get the simple answer 'kern', do the following. path = abs2rel(realpath("/sys/kern", r1), realpath("/sys", r2), result, MAXPATHLEN); diff --git a/lib/libpmc/pmc.sandybridge.3 b/lib/libpmc/pmc.sandybridge.3 index 0e219ae3aeaa..a0bd457e2147 100644 --- a/lib/libpmc/pmc.sandybridge.3 +++ b/lib/libpmc/pmc.sandybridge.3 @@ -1,4 +1,4 @@ -.\" Copyright (c) 2012 Davide Italiano <davide@FreeBSD.org> +.\" Copyright (c) 2012 Davide Italiano <davide@FreeBSD.org> .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without diff --git a/lib/libpmc/pmc.sandybridgeuc.3 b/lib/libpmc/pmc.sandybridgeuc.3 index 0215c36a45d7..f78ff10de4fe 100644 --- a/lib/libpmc/pmc.sandybridgeuc.3 +++ b/lib/libpmc/pmc.sandybridgeuc.3 @@ -1,4 +1,4 @@ -.\" Copyright (c) 2012 Davide Italiano <davide@FreeBSD.org> +.\" Copyright (c) 2012 Davide Italiano <davide@FreeBSD.org> .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without diff --git a/lib/libradius/libradius.3 b/lib/libradius/libradius.3 index f3ff70058d44..27612b73a1e3 100644 --- a/lib/libradius/libradius.3 +++ b/lib/libradius/libradius.3 @@ -485,7 +485,8 @@ To free the resources used by the RADIUS library, call .Fn rad_close . .Ss Server operation Server mode operates much alike to client mode, except packet send and receive -steps are swapped. To operate as server you should obtain server context with +steps are swapped. +To operate as server you should obtain server context with .Fn rad_server_open function, passing opened and bound UDP socket file descriptor as argument. You should define allowed clients and their secrets using @@ -493,9 +494,9 @@ You should define allowed clients and their secrets using function. port, timeout and max_tries arguments are ignored in server mode. You should call .Fn rad_receive_request -function to receive request from client. If you do not want to block on socket -read, you are free to use any poll(), select() or non-blocking sockets for -the socket. +function to receive request from client. +If you do not want to block on socket read, you are free to use any +poll(), select() or non-blocking sockets for the socket. Received request can be parsed with same parsing functions as for client. To respond to the request you should call .Fn rad_create_response diff --git a/lib/librpcsec_gss/rpc_gss_set_callback.3 b/lib/librpcsec_gss/rpc_gss_set_callback.3 index 54f3f517680d..a988e300c5bf 100644 --- a/lib/librpcsec_gss/rpc_gss_set_callback.3 +++ b/lib/librpcsec_gss/rpc_gss_set_callback.3 @@ -74,7 +74,8 @@ GSS-API delegated credentials (if any) .It gss_context The GSS-API context .It lock -A structure used to enforce a particular QOP and service. Set +A structure used to enforce a particular QOP and service. +Set .Fa lock->locked to .Dv TRUE diff --git a/lib/libsysdecode/sysdecode_mask.3 b/lib/libsysdecode/sysdecode_mask.3 index d7e22dca9d63..54e182db31d7 100644 --- a/lib/libsysdecode/sysdecode_mask.3 +++ b/lib/libsysdecode/sysdecode_mask.3 @@ -194,17 +194,17 @@ and .Xr fcntl 2 commands. .It Fn sysdecode_sctp_nxt_flags -The +The .Fa nxt_flags member of a .Vt struct sctp_nxtinfo . .It Fn sysdecode_sctp_rcv_flags -The +The .Fa rcv_flags member of a .Vt struct sctp_rcvinfo . .It Fn sysdecode_sctp_snd_flags -The +The .Fa snd_flags member of a .Vt struct sctp_sndinfo . diff --git a/lib/libusb/libusb20.3 b/lib/libusb/libusb20.3 index eef79bd4658d..66d868cfea37 100644 --- a/lib/libusb/libusb20.3 +++ b/lib/libusb/libusb20.3 @@ -314,15 +314,16 @@ This function returns NULL in case of failure. . .Fn libusb20_tr_get_time_complete will return the completion time of an USB transfer in -millisecond units. This function is most useful for isochronous USB -transfers when doing echo cancelling. +millisecond units. +This function is most useful for isochronous USB transfers when doing echo +cancelling. . .Pp . .Fn libusb20_tr_get_actual_frames will return the actual number of USB frames after an USB -transfer completed. A value of zero means that no data was transferred. -. +transfer completed. +A value of zero means that no data was transferred. .Pp . .Fn libusb20_tr_get_actual_length @@ -691,9 +692,11 @@ Before this call will succeed the USB device must be opened. .Fa setup is a pointer to a decoded and host endian SETUP packet. .Fa data -is a pointer to a data transfer buffer associated with the control transaction. This argument can be NULL. +is a pointer to a data transfer buffer associated with the control transaction. +This argument can be NULL. .Fa pactlen -is a pointer to a variable that will hold the actual transfer length after the control transaction is complete. +is a pointer to a variable that will hold the actual transfer length after the +control transaction is complete. .Fa timeout is the transaction timeout given in milliseconds. A timeout of zero means no timeout. @@ -792,10 +795,11 @@ The USB device need not be opened when calling this function. .Pp . .Fn libusb20_dev_alloc_config -will read out and decode the USB config descriptor for -the given USB device and config index. This function returns a pointer -to the decoded configuration which must eventually be passed to -free(). NULL is returned in case of failure. +will read out and decode the USB config descriptor for the given USB device +and config index. +This function returns a pointer to the decoded configuration which must eventually +be passed to free(). +NULL is returned in case of failure. . .Pp . @@ -902,8 +906,8 @@ will set the global USB device side mode template to The new template is not activated until after the next USB enumeration. The template number decides how the USB device will present itself to -the USB Host, like Mass Storage Device, USB Ethernet Device. Also see -the +the USB Host, like Mass Storage Device, USB Ethernet Device. +Also see the .Xr usb2_template 4 module. This function returns zero on success else a LIBUSB20_ERROR value is @@ -966,10 +970,9 @@ returned. .Fn libusb20_be_alloc_default .Fn libusb20_be_alloc_freebsd .Fn libusb20_be_alloc_linux -These functions are used to allocate a specific USB backend or the -operating system default USB backend. Allocating a backend is a way to -scan for currently present USB devices. -. +These functions are used to allocate a specific USB backend or the operating system +default USB backend. +Allocating a backend is a way to scan for currently present USB devices. .Pp . .Fn libusb20_be_device_foreach diff --git a/lib/libutil/login_ok.3 b/lib/libutil/login_ok.3 index b43906e1f471..c18e94ed680e 100644 --- a/lib/libutil/login_ok.3 +++ b/lib/libutil/login_ok.3 @@ -19,7 +19,7 @@ .\" .\" $FreeBSD$ .\" -.Dd May 10, 2020 +.Dd May 10, 2020 .Dt LOGIN_OK 3 .Os .Sh NAME diff --git a/lib/msun/man/sincos.3 b/lib/msun/man/sincos.3 index 9c42a9605710..7d44bea931b1 100644 --- a/lib/msun/man/sincos.3 +++ b/lib/msun/man/sincos.3 @@ -50,33 +50,33 @@ and functions compute the sine and cosine of .Fa x . Using these functions allows argument reduction to occur only -once instead of twice with individual invocations of +once instead of twice with individual invocations of .Fn sin -and +and .Fn cos . -Like +Like .Fn sin -and +and .Fn cos , a large magnitude argument may yield a result with little or no significance. .Sh RETURN VALUES -Upon returning from +Upon returning from .Fn sincos , .Fn sincosf , and .Fn sincosl , -the memory pointed to by -.Ar "*s" +the memory pointed to by +.Ar "*s" and -.Ar "*c" +.Ar "*c" are assigned the values of sine and cosine, respectively. .Sh SEE ALSO .Xr cos 3 , .Xr sin 3 , .Sh HISTORY -These functions were added to +These functions were added to .Fx 9.0 -to aid in writing various complex function contained in +to aid in writing various complex function contained in .St -isoC-99 . |