del_ipc_prof

Purpose

     Deletes an IPC queue profile.

Library

     IPC Library (libipc.a)

Syntax

     #include <drs.h>

     int del_ipc_prof  (queue_name, l_key, r_key, nickname)

     char *queue_name;
     key_t *l_key, *r_key;
     char *nickname;

Description

     The del_ipc_prof subroutine deletes  an IPC queue profile
     at the local node.  A process must have an effective user
     ID of superuser in order  to use the del_ipc_prof subrou-
     tine.

     The  queue_name parameter  contains  the name  of an  IPC
     queue.  The l_key  parameter points to the  local key for
     an  IPC queue.   You must  specify one  or both  of these
     values.  If the fields pointed to by queue_name and l_key
     are both 0, the del_ipc_prof subroutine fails.

     The r_key  is a pointer  from the  local node to  the IPC
     profile  for a  queue  at a  remote  node.  The  nickname
     parameter points to the node ID (in hexadecimal) or nick-
     name  of the  node where  the IPC  queue exists.   If the
     nickname parameter points to a  null string, the queue is
     on the local node.

     The application does not supply  values for the r_key and
     nickname parameters.  The del_ipc_prof subroutine assigns
     values to these parameters when it returns.  The applica-
     tion, however, must ensure that enough space is allocated
     to hold the return values.

     If  del_ipc_prof   successfully  deletes   the  requested
     profile, the dsipc command is used to update the kernel's
     copy of the profiles.

Return Value

     Upon successful completion, the function returns a 0, and
     queue_name, l_key, r_key, and nickname contain the values
     from   the  deleted   profile.   If   an  error   occurs,
     del_ipc_prof returns a negative  value from the following
     list:

     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 pfsmain.

     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_INBLCK   The  profile  data  base is  locked  against
                  updates.

     DRS_INTENT   Intentions denied.

     DRS_ISDIR    A write to a directory was attempted.

     DRS_LOCKPM   Lock permission denied.

     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

     In  this   book:     "create_ipc_prof,"  --   Heading  id
     'fipcpro' unknown --, and "msgctl."

     The dsipc command in AIX Operating System Commands Refer-
     ence.

     The discussion  of messages and  IPC queues in  AIX Oper-
     ating System Programming Tools and Interfaces.