Xinu7/man/man2/pdelete.doc

PDELETE(2)          Xinu Programmer's Manual           PDELETE(2)



NAME
     pdelete - delete a port

SYNOPSIS
     int pdelete(portid, dispose)
     int portid;
     int (*dispose)();

DESCRIPTION
     _P_d_e_l_e_t_e deallocates port _p_o_r_t_i_d. The call returns SYSERR if
     _p_o_r_t_i_d is illegal or is not currently allocated.

     The command has several effects, depending on the state of
     the port at the time the call is issued.  If processes are
     waiting for messages from portid, they are made ready and
     return SYSERR to their caller. If messages exist in the
     port, they are disposed of by procedure _d_i_s_p_o_s_e.  If
     processes are waiting to place messages in the port, they
     are made ready and given SYSERR indications (just as if the
     port never existed).  _P_d_e_l_e_t_e performs the same function of
     clearing messages and processes from a port as PRESET(2)
     except that _p_d_e_l_e_t_e also deallocates the port.

SEE ALSO
     pcount(2), pcreate(2), preceive(2), preset(2), psend(2)






























Version 6b               Printed 1/12/87                        1