addopt(3N)

Requires Optional LAN/X.25 Software

NAME

addopt − add argument and data to NetIPC option buffer

SYNOPSIS

#include <sys/ns_ipc.h>

void addopt(

short opt[],
short argnum,
short optioncode,
short datalength,
short data[],
short ∗result);

DESCRIPTION

addopt adds an argument and its associated data to a NetIPC opt buffer. A NetIPC option buffer is a data array structured and used by NetIPC. The size of the data array can be determined by calling optoverhead(3N). The buffer must be initialized by calling initopt(3N).

Parameters

opt (input parameter) The opt buffer to which you want to add an argument.

argnum (input parameter) The number of the argument to be added. The first argument is number zero.

optioncode (input parameter) The option code of the argument to be added. These codes are described in each Net IPC system call opt parameter description.

datalength (input parameter) The length in bytes of the data to be included. This information is provided in each Net IPC system call opt parameter description.

data (input parameter) An array containing the data associated with the argument.

result (output parameter) The result code returned. Refer to "Diagnostics" below for more information.

RETURN VALUE

None. Errors are returned in the result parameter.

DIAGNOSTICS

[NSR_ADDR_OPT] An unknown or illegal option number was specified.

[NSR_NO_ERROR] The call was successful.

[NSR_OPT_DATA_LEN] The length of the opt parameter is less than 0.

[NSR_OPT_ENTRY_NUM] Option index is less than 0 or greater than the option buffer for which it was initialized. If an option buffer is initialized for 3 options, number the options as 0, 1, and 2. In this example, the number 3 is illegal.

AUTHOR

addopt was developed by HP.

Museum

Related Articles