.Fa object

.Fa object

to its desired

to its desired

.Fa value

.Fa value

.Pp

.Pp

The

The

.Fn atomic_compare_exchange_strong

.Fn atomic_compare_exchange_strong

.Fn atomic_fetch_sub

.Fn atomic_fetch_sub

macro subtracts the value

macro subtracts the value

.Fa operand

.Fa operand

.Fa object

.Fa object

and returns the original contents of the atomic variable.

and returns the original contents of the atomic variable.

.Pp

.Pp

.Os

.Os

.Sh NAME

.Sh NAME

.Nm acl_delete_entry ,

.Nm acl_delete_entry ,

.Nd delete an ACL entry from an ACL

.Nd delete an ACL entry from an ACL

.Sh LIBRARY

.Sh LIBRARY

.Lb libc

.Lb libc

zero.

zero.

If the skip callback is not provided (the

If the skip callback is not provided (the

function pointer is

function pointer is

the library will invoke the read function

the library will invoke the read function

instead and simply discard the result.

instead and simply discard the result.

A skip callback can provide significant

A skip callback can provide significant

.Fn archive_set_error

.Fn archive_set_error

to register an error code and message and

to register an error code and message and

return

return

.\" .Sh EXAMPLE

.\" .Sh EXAMPLE

.\"

.\"

.Sh RETURN VALUES

.Sh RETURN VALUES

.Nm archive_write_add_filter_none ,

.Nm archive_write_add_filter_none ,

.Nm archive_write_add_filter_program ,

.Nm archive_write_add_filter_program ,

.Nm archive_write_add_filter_xz

.Nm archive_write_add_filter_xz

.Sh SYNOPSIS

.Sh SYNOPSIS

.In archive.h

.In archive.h

.Ft int

.Ft int

.Fn archive_set_error

.Fn archive_set_error

to register an error code and message and

to register an error code and message and

return

return

.Pp

.Pp

Note that if the client-provided write callback function

Note that if the client-provided write callback function

returns a non-zero value, that error will be propagated back to the caller

returns a non-zero value, that error will be propagated back to the caller

the default is

the default is

.Cm fd ,

.Cm fd ,

otherwise the default is

otherwise the default is

.El

.El

.It Format iso9660 - filename and size extensions

.It Format iso9660 - filename and size extensions

Various extensions to the base ISO9660 format.

Various extensions to the base ISO9660 format.

.Xr bt_devopen 3 .

.Xr bt_devopen 3 .

Filtering can be done on packet types, i.e.

Filtering can be done on packet types, i.e.

.Dv ACL ,

.Dv ACL ,

.Dv HCI ,

.Dv HCI ,

command and event packets, and, in addition, on

command and event packets, and, in addition, on

.Dv HCI

.Dv HCI

.Fa z ,

.Fa z ,

also known as

also known as

.Em cis Ns ( Ns

.Em cis Ns ( Ns

.Sh RETURN VALUES

.Sh RETURN VALUES

For real numbers

For real numbers

.Fa x

.Fa x

functions described here conform to

functions described here conform to

.St -isoC-99 .

.St -isoC-99 .

.Sh BUGS

.Sh BUGS

.Fn cacos ,

.Fn cacos ,

.Fn cacosh ,

.Fn cacosh ,

.Fn casin ,

.Fn casin ,

that refers to the same locale values but has independent internal state.

that refers to the same locale values but has independent internal state.

Various functions, such as

Various functions, such as

.Xr mblen 3

.Xr mblen 3

These functions formerly used static variables and calls to them from multiple

These functions formerly used static variables and calls to them from multiple

threads had undefined behavior.

threads had undefined behavior.

They now use fields in the

They now use fields in the

If the archive

If the archive

.Ar elf

.Ar elf

contains a symbol table with n entries, this function returns a

contains a symbol table with n entries, this function returns a

.Vt Elf_Arsym

.Vt Elf_Arsym

structures.

structures.

An

An

.Dv ELF_T_BYTE .

.Dv ELF_T_BYTE .

.Ss Special handling of zero-sized and SHT_NOBITS sections

.Ss Special handling of zero-sized and SHT_NOBITS sections

For sections of type

For sections of type

and for zero-sized sections,

and for zero-sized sections,

the functions

the functions

.Fn elf_getdata

.Fn elf_getdata

.Os

.Os

.Sh NAME

.Sh NAME

.Nm elf_rand

.Nm elf_rand

.Sh LIBRARY

.Sh LIBRARY

.Lb libelf

.Lb libelf

.Sh SYNOPSIS

.Sh SYNOPSIS

.It Bq Er ELF_E_ARGUMENT

.It Bq Er ELF_E_ARGUMENT

Argument

Argument

.Ar elf

.Ar elf

.It Bq Er ELF_E_ARGUMENT

.It Bq Er ELF_E_ARGUMENT

Argument

Argument

.Ar elf

.Ar elf

.Nd Frees a locale created with

.Nd Frees a locale created with

.Xr duplocale 3

.Xr duplocale 3

or

or

.Sh LIBRARY

.Sh LIBRARY

.Lb libc

.Lb libc

.Sh SYNOPSIS

.Sh SYNOPSIS

will retrieve the program header table entry at index

will retrieve the program header table entry at index

.Ar index

.Ar index

from ELF descriptor

from ELF descriptor

The translated program header table entry will be written to the

The translated program header table entry will be written to the

address pointed to be argument

address pointed to be argument

.Ar dst .

.Ar dst .

Function

Function

.Fn elf64_newehdr

.Fn elf64_newehdr

returns a pointer to a 64 bit

returns a pointer to a 64 bit

.Pp

.Pp

When argument

When argument

.Ar elfclass

.Ar elfclass

is a

is a

.Dv NULL

.Dv NULL

pointer,

pointer,

.Dq Li \&=

.Dq Li \&=

character or

character or

.Dq Li \&=

.Dq Li \&=

.Fn getopt_long_only

.Fn getopt_long_only

functions first appeared in the

functions first appeared in the

.Tn GNU

.Tn GNU

The first

The first

.Bx

.Bx

implementation of

implementation of

.Pp

.Pp

The function

The function

.Fn ibwrtkey

.Fn ibwrtkey

.Pp

.Pp

The function

The function

.Fn ibxtrc

.Fn ibxtrc

On success, the

On success, the

.Fn kvm_getpcpu

.Fn kvm_getpcpu

function returns a pointer to an allocated buffer or

function returns a pointer to an allocated buffer or

If an error occurs,

If an error occurs,

it returns -1 instead.

it returns -1 instead.

.Pp

.Pp

.Pp

.Pp

If any function encounters an error,

If any function encounters an error,

then an error message may be retrieved via

then an error message may be retrieved via

.Sh SEE ALSO

.Sh SEE ALSO

.Xr free 3 ,

.Xr free 3 ,

.Xr kvm 3

.Xr kvm 3

.An Paolo Pisati Aq piso@FreeBSD.org

.An Paolo Pisati Aq piso@FreeBSD.org

made the library modular, moving support for all

made the library modular, moving support for all

protocols (except for IP, TCP and UDP) to external modules.

protocols (except for IP, TCP and UDP) to external modules.

Listed below, in approximate chronological order, are individuals who

Listed below, in approximate chronological order, are individuals who

have provided valuable comments and/or debugging assistance.

have provided valuable comments and/or debugging assistance.

.Bd -ragged -offset indent

.Bd -ragged -offset indent

.Ed

.Ed

.Bl -inset

.Bl -inset

.It Va name

.It Va name

.It Va handle

.It Va handle

is a pointer to the module obtained through

is a pointer to the module obtained through

.El

.El

Whenever a module is loaded in userland, an entry is added to

Whenever a module is loaded in userland, an entry is added to

.Va dll_chain ,

.Va dll_chain ,

entire file to libarchive as a single block;

entire file to libarchive as a single block;

other clients may begin asynchronous I/O operations for the

other clients may begin asynchronous I/O operations for the

next block on each request.

next block on each request.

The decompression layer not only handles decompression,

The decompression layer not only handles decompression,

it also buffers data so that the format handlers see a

it also buffers data so that the format handlers see a

much nicer I/O model.

much nicer I/O model.

.Fn procstat_get_socket_info

.Fn procstat_get_socket_info

and

and

.Fn procstat_get_vnode_info

.Fn procstat_get_vnode_info

shared memory objects,

shared memory objects,

sockets, and vnodes, respectively.

sockets, and vnodes, respectively.

Each of them have a similar interface API.

Each of them have a similar interface API.

network requests to remote servers.

network requests to remote servers.

.Ss Initialization

.Ss Initialization

To use the library, an application must first call

To use the library, an application must first call

.Fn rad_acct_open

.Fn rad_acct_open

or

or

.Fn rad_server_open

.Fn rad_server_open

The former function is used for RADIUS authentication and the

The former function is used for RADIUS authentication and the

latter is used for RADIUS accounting.

latter is used for RADIUS accounting.

Calls to

Calls to

.Fn rad_acct_open

.Fn rad_acct_open

and

and

.Fn rad_server_open

.Fn rad_server_open

.Fn rad_create_response

.Fn rad_create_response

and fill response content with same packet writing functions as for client.

and fill response content with same packet writing functions as for client.

When packet is ready, it should be sent with

When packet is ready, it should be sent with

.Sh RETURN VALUES

.Sh RETURN VALUES

The following functions return a non-negative value on success.

The following functions return a non-negative value on success.

If

If

On failure,

On failure,

.Fn tac_send_acct

.Fn tac_send_acct

returns \-1.

returns \-1.

Possible status codes, defined in

Possible status codes, defined in

.In taclib.h ,

.In taclib.h ,

include:

include:

.Ft uint8_t

.Ft uint8_t

.Fn libusb_get_bus_number "libusb_device *dev"

.Fn libusb_get_bus_number "libusb_device *dev"

Returns the number of the bus contained by the device

Returns the number of the bus contained by the device

.Pp

.Pp

.Ft uint8_t

.Ft uint8_t

.Fn libusb_get_device_address "libusb_device *dev"

.Fn libusb_get_device_address "libusb_device *dev"

Returns the device_address contained by the device

Returns the device_address contained by the device

.Pp

.Pp

.Ft enum libusb_speed

.Ft enum libusb_speed

.Fn libusb_get_device_speed "libusb_device *dev"

.Fn libusb_get_device_speed "libusb_device *dev"

.Ft libusb_device *

.Ft libusb_device *

.Fn libusb_ref_device "libusb_device *dev"

.Fn libusb_ref_device "libusb_device *dev"

Increment the reference counter of the device

Increment the reference counter of the device

.Pp

.Pp

.Ft void

.Ft void

.Fn libusb_unref_device "libusb_device *dev"

.Fn libusb_unref_device "libusb_device *dev"

Decrement the reference counter of the device

Decrement the reference counter of the device

.Pp

.Pp

.Ft int

.Ft int

.Fn libusb_open "libusb_device *dev" "libusb_device_handle **devh"

.Fn libusb_open "libusb_device *dev" "libusb_device_handle **devh"

A convenience function to open a device by vendor and product IDs

A convenience function to open a device by vendor and product IDs

.Fa vid

.Fa vid

and

and

Returns NULL on error.

Returns NULL on error.

.Pp

.Pp

.Ft void

.Ft void

.Pp

.Pp

.Ft int

.Ft int

.Fn libusb_get_configuration "libusb_device_handle *devh" "int *config"

.Fn libusb_get_configuration "libusb_device_handle *devh" "int *config"

Returns 0

Returns 0

on success, LIBUSB_ERROR_NO_DEVICE if the device has been disconnected

on success, LIBUSB_ERROR_NO_DEVICE if the device has been disconnected

and a LIBUSB_ERROR code on error.

and a LIBUSB_ERROR code on error.

Set the active configuration to

Set the active configuration to

.Fa config

.Fa config

for the device contained by

for the device contained by

This function returns 0 on success, LIBUSB_ERROR_NOT_FOUND if the requested

This function returns 0 on success, LIBUSB_ERROR_NOT_FOUND if the requested

configuration does not exist, LIBUSB_ERROR_BUSY if the interfaces are currently

configuration does not exist, LIBUSB_ERROR_BUSY if the interfaces are currently

claimed, LIBUSB_ERROR_NO_DEVICE if the device has been disconnected and a

claimed, LIBUSB_ERROR_NO_DEVICE if the device has been disconnected and a

.Ft int

.Ft int

.Fn libusb_claim_interface "libusb_device_handle *devh" "int interface_number"

.Fn libusb_claim_interface "libusb_device_handle *devh" "int interface_number"

Claim an interface in a given libusb_handle

Claim an interface in a given libusb_handle

This is a non-blocking function.

This is a non-blocking function.

It returns 0 on success, LIBUSB_ERROR_NOT_FOUND

It returns 0 on success, LIBUSB_ERROR_NOT_FOUND

if the requested interface does not exist, LIBUSB_ERROR_BUSY if a program or

if the requested interface does not exist, LIBUSB_ERROR_BUSY if a program or

.Ft int

.Ft int

.Fn libusb_get_device_descriptor "libusb_device *dev" "libusb_device_descriptor *desc"

.Fn libusb_get_device_descriptor "libusb_device *dev" "libusb_device_descriptor *desc"

Get the USB device descriptor for the device

Get the USB device descriptor for the device

This is a non-blocking function.

This is a non-blocking function.

Returns 0 on success and a LIBUSB_ERROR code on

Returns 0 on success and a LIBUSB_ERROR code on

failure.

failure.

This function parses the USB 3.0 endpoint companion descriptor in host endian format pointed to by

This function parses the USB 3.0 endpoint companion descriptor in host endian format pointed to by

.Fa buf

.Fa buf

and having a length of

and having a length of

Typically these arguments are the extra and extra_length fields of the

Typically these arguments are the extra and extra_length fields of the

endpoint descriptor.

endpoint descriptor.

On success the pointer to resulting descriptor is stored at the location given by

On success the pointer to resulting descriptor is stored at the location given by

Returns zero on success and a LIBUSB_ERROR code on failure.

Returns zero on success and a LIBUSB_ERROR code on failure.

On success the parsed USB 3.0 endpoint companion descriptor must be

On success the parsed USB 3.0 endpoint companion descriptor must be

freed using the libusb_free_ss_endpoint_comp function.

freed using the libusb_free_ss_endpoint_comp function.

This function parses a Binary Object Store, BOS, descriptor into host endian format pointed to by

This function parses a Binary Object Store, BOS, descriptor into host endian format pointed to by

.Fa buf

.Fa buf

and having a length of

and having a length of

On success the pointer to resulting descriptor is stored at the location given by

On success the pointer to resulting descriptor is stored at the location given by

Returns zero on success and a LIBUSB_ERROR code on failure.

Returns zero on success and a LIBUSB_ERROR code on failure.

On success the parsed BOS descriptor must be freed using the

On success the parsed BOS descriptor must be freed using the

libusb_free_bos_descriptor function.

libusb_free_bos_descriptor function.

.Pp

.Pp

.

.

.Fn libusb20_tr_get_max_total_length

.Fn libusb20_tr_get_max_total_length

frames associated with an USB transfer.

frames associated with an USB transfer.

In case of control transfers the value returned does not include the

In case of control transfers the value returned does not include the

length of the SETUP packet, 8 bytes, which is part of frame zero.

length of the SETUP packet, 8 bytes, which is part of frame zero.

.Pp

.Pp

.

.

.Fn libusb20_dev_get_config_index

.Fn libusb20_dev_get_config_index

USB device.

USB device.

.

.

.Pp

.Pp

.Pp

.Pp

.

.

.Fn libusb20_dev_wait_process

.Fn libusb20_dev_wait_process

the given USB device.

the given USB device.

.

.

A timeout value can be specified which is passed on to the

A timeout value can be specified which is passed on to the

.Pp

.Pp

.

.

.Fn libusb20_be_get_dev_quirk

.Fn libusb20_be_get_dev_quirk

.Fa index

.Fa index

into the libusb20_quirk structure pointed to by

into the libusb20_quirk structure pointed to by

.Fa pq .

.Fa pq .

.Pp

.Pp

.

.

.Fn libusb20_be_enqueue_device

.Fn libusb20_be_enqueue_device

.

.

Enqueued USB devices will get freed when the backend is freed.

Enqueued USB devices will get freed when the backend is freed.

.

.

The

The

.Fa mask

.Fa mask

is either

is either

indicating all possible locale components,

indicating all possible locale components,

or the logical OR of some combination of the following:

or the logical OR of some combination of the following:

.Bl -tag -width "LC_MESSAGES_MASK" -offset indent

.Bl -tag -width "LC_MESSAGES_MASK" -offset indent

The locale for string collation routines.

The locale for string collation routines.

This controls alphabetic ordering in

This controls alphabetic ordering in

.Xr strcoll 3

.Xr strcoll 3

.Xr strxfrm 3 .

.Xr strxfrm 3 .

.It LC_CTYPE_MASK

.It LC_CTYPE_MASK

The locale for the

The locale for the

.Fa "void \*[lp]*child\*[rp]\*[lp]void\*[rp]"

.Fa "void \*[lp]*child\*[rp]\*[lp]void\*[rp]"

.Fc

.Fc

.Xc

.Xc

.It Xo

.It Xo

.Ft void

.Ft void

.Fn pthread_cleanup_pop "int execute"

.Fn pthread_cleanup_pop "int execute"

.Nm pthread_condattr_getclock ,

.Nm pthread_condattr_getclock ,

.Nm pthread_condattr_setclock ,

.Nm pthread_condattr_setclock ,

.Nm pthread_condattr_getpshared ,

.Nm pthread_condattr_getpshared ,

.Nd condition attribute operations

.Nd condition attribute operations

.Sh LIBRARY

.Sh LIBRARY

.Lb libpthread

.Lb libpthread

which is used to decrypt the encrypted secret key stored in the database.

which is used to decrypt the encrypted secret key stored in the database.

Both routines return 1 if they are successful in finding the key, 0 otherwise.

Both routines return 1 if they are successful in finding the key, 0 otherwise.

The keys are returned as

The keys are returned as

hexadecimal strings.

hexadecimal strings.

If the password supplied to

If the password supplied to

.Fn getsecretkey

.Fn getsecretkey

fails to decrypt the secret key, the routine will return 1 but the

fails to decrypt the secret key, the routine will return 1 but the

.Fa secretkey

.Fa secretkey

argument will be a

argument will be a

string

string

.Pq Dq .

.Pq Dq .

.Sh SEE ALSO

.Sh SEE ALSO

.Os

.Os

.Sh NAME

.Sh NAME

.Nm querylocale

.Nm querylocale

.Sh LIBRARY

.Sh LIBRARY

.Lb libc

.Lb libc

.Sh SYNOPSIS

.Sh SYNOPSIS

.Fn querylocale "int mask" "locale_t locale"

.Fn querylocale "int mask" "locale_t locale"

.Sh DESCRIPTION

.Sh DESCRIPTION

Returns the name of the locale for the category specified by

Returns the name of the locale for the category specified by

This possible values for the mask are the same as those in

This possible values for the mask are the same as those in

.Xr newlocale 3 .

.Xr newlocale 3 .

If more than one bit in the mask is set, the returned value is undefined.

If more than one bit in the mask is set, the returned value is undefined.

.Os

.Os

.Sh NAME

.Sh NAME

.Nm sctp_connectx

.Nm sctp_connectx

.Sh LIBRARY

.Sh LIBRARY

.Lb libc

.Lb libc

.Sh SYNOPSIS

.Sh SYNOPSIS

.Fn sctp_recvmsg

.Fn sctp_recvmsg

after having implicitly started an association via one

after having implicitly started an association via one

of the send calls including

of the send calls including

.Fn sendto

.Fn sendto

and

and

.Fn sendmsg .

.Fn sendmsg .

.Li NG_NODESIZ

.Li NG_NODESIZ

bytes long.

bytes long.

The function returns the node id or 0 if the

The function returns the node id or 0 if the

.Pp

.Pp

The function

The function

.Fn ng_node_type

.Fn ng_node_type

.Fa peer .

.Fa peer .

The functions return 0 on success or -1 otherwise.

The functions return 0 on success or -1 otherwise.

The function

The function

.Fn ng_connect2_id

.Fn ng_connect2_id

except, that it puts an unnamed tee node between the two nodes.

except, that it puts an unnamed tee node between the two nodes.

.Pp

.Pp

altering the SNMP USM users.

altering the SNMP USM users.

.It Va usmUserTable

.It Va usmUserTable

The table contains all SNMP USM users configured in

The table contains all SNMP USM users configured in

The table contains the following objects

The table contains the following objects

.Bl -tag -width ".It Va usmUserEngineID"

.Bl -tag -width ".It Va usmUserEngineID"

.It Va usmUserEngineID

.It Va usmUserEngineID

These columns may be used to change the user's privacy key.

These columns may be used to change the user's privacy key.

.It Va usmUserPublic

.It Va usmUserPublic

An arbitrary octet string that may be modified to confirm a SET operation on any

An arbitrary octet string that may be modified to confirm a SET operation on any

.It Va usmUserStorageType

.It Va usmUserStorageType

This column always has either of two values. Entries created via

This column always has either of two values. Entries created via

.Nm bsnmpd's

.Nm bsnmpd's

.It Va vacmViewTreeFamilyTable

.It Va vacmViewTreeFamilyTable

The table contains a list of SNMP views, i.e. entries specifying the OID of a

The table contains a list of SNMP views, i.e. entries specifying the OID of a

MIB subtree and whether access to the objects under this subtree is to be

MIB subtree and whether access to the objects under this subtree is to be

.El

.El

.Sh FILES

.Sh FILES

.Bl -tag -width "XXXXXXXXX"

.Bl -tag -width "XXXXXXXXX"

.Va wlanParentIfName

.Va wlanParentIfName

column. Any optional parameters may be set

column. Any optional parameters may be set

via the

via the

.Va wlanIfaceBssid

.Va wlanIfaceBssid

and

and

.Va wlanIfaceLocalAddress

.Va wlanIfaceLocalAddress

.Fn getsourcefilter

.Fn getsourcefilter

and

and

.Fn setsourcefilter ,

.Fn setsourcefilter ,

.Fa grouplen

.Fa grouplen

argument specifies the size of the structure pointed to by

argument specifies the size of the structure pointed to by

.Fa group .

.Fa group .

.Sh SEE ALSO

.Sh SEE ALSO

.Xr ip 4 ,

.Xr ip 4 ,

.Xr ip6 4 ,

.Xr ip6 4 ,

.Xr ifmcstat 8

.Xr ifmcstat 8

.Rs

.Rs

.%A D. Thaler

.%A D. Thaler

.El

.El

.Sh RETURN VALUES

.Sh RETURN VALUES

If the total number of resulting bytes including the terminating

If the total number of resulting bytes including the terminating

byte is not more than

byte is not more than

.Fa maxsize ,

.Fa maxsize ,

.Fn strfmon

.Fn strfmon

returns the number of bytes placed into the array pointed to by

returns the number of bytes placed into the array pointed to by

.Fa s ,

.Fa s ,

not including the terminating

not including the terminating

byte.

byte.

Otherwise, \-1 is returned,

Otherwise, \-1 is returned,

the contents of the array are indeterminate,

the contents of the array are indeterminate,

.Ed

.Ed

.Pp

.Pp

Since it is known how many characters were copied the first time, things

Since it is known how many characters were copied the first time, things

.Bd -literal -offset indent

.Bd -literal -offset indent

char *dir, *file, pname[MAXPATHLEN];

char *dir, *file, pname[MAXPATHLEN];

size_t n;

size_t n;

.Os

.Os

.Sh NAME

.Sh NAME

.Nm uselocale

.Nm uselocale

.Sh LIBRARY

.Sh LIBRARY

.Lb libc

.Lb libc

.Sh SYNOPSIS

.Sh SYNOPSIS

.Os

.Os

.Sh NAME

.Sh NAME

.Nm xlocale

.Nm xlocale

.Sh LIBRARY

.Sh LIBRARY

.Lb libc

.Lb libc

.Sh SYNOPSIS

.Sh SYNOPSIS