drsname, drsnidd
Purpose
Returns the associated node ID for a given node nickname
or the associated nickname for a given node ID.
Library
IPC Library (libipc.a)
Syntax
#include <drs.h>
int drsname (nickname, nid) int drsnidd (nid, nickname)
char *nickname; long nid;
long *nid; char *nickname;
Description
The drsname subroutine returns the associated node ID for
a given nickname. The nickname parameter points to a
null-terminated string containing the nickname for which
the node ID is to be returned. The nid parameter points
to the location of the returned node ID.
The drsnidd subroutine returns the associated node nick-
name for a given node ID. The nid parameter contains the
node ID for which the nickname is to be returned. The
nickname parameter is a null-terminated string that
points to the returned nickname. The calling process
must reserve enough memory to contain the returned infor-
mation, which is a maximum of 14 characters plus the
trailing NULL.
Return Value
Upon successful completion, these functions return a
value of 0. If an error occurs, they return one of the
following negative values:
DRS_ACCES The required access permissions were denied.
DRS_BADLEN An incorrect parameter was supplied.
DRS_NOREC No record was found.
DRS_IO An input/output error occurred.
DRS_AGAIN Unable to start Profile Services.
DRS_BADF An incorrect file descriptor was supplied.
DRS_BADK An incorrect index key was supplied.
DRS_BDMSF An incorrect file or table was supplied.
DRS_BOF The beginning of the file was encountered.
DRS_DEADLK A deadlock was detected.
DRS_EOF The end of the file was encountered.
DRS_FAULT An incorrect address was supplied.
DRS_FBIG The maximum file size was exceeded.
DRS_IDRM Identifier removed.
DRS_INTENT Intentions denied.
DRS_ISDIR A write to a directory was attempted.
DRS_MFILE Too many files, tables, or indexes were
open.
DRS_NFILE The file table overflowed.
DRS_NOENT No file or directory was found.
DRS_NOMEM No memory is available.
DRS_NOSPC No space is available on the device.
DRS_NOTDIR Not a directory.
DRS_NOTIDX Not an index.
DRS_PANIC Abnormal termination occurred.
DRS_RCVRY File needs recovery.
DRS_RECLEN Record length is invalid.
DRS_ROFS The file system to be accessed is read-only.
Related Information
Managing the AIX Operating System.