pdisable, phold

PURPOSE

     Disables or reports the availability of login ports.

SYNOPSIS
     pstart [[-i -w]][-a][device]
     pshare [[-i -w]][-a][device]
     penable [[-i -w]][-a][device]
     pdelay [[-i -w]][-a][device]

     pdisable [-w][-a][device]
     phold    [-w][-a][device]


DESCRIPTION

     The pdisable  and phold  commands each  disable a  set of
     login ports.  Disabling a port makes the port unavailable
     to log  in.  The  system disables a  port by  updating an
     entry  in the  /etc/portstatus  file and  then sending  a
     signal to init.  When init  receives the signal and reads
     the  updated  status  entry,  it  takes  the  appropriate
     action.

     Use  the device  parameter  to specify  the  ports to  be
     enabled.  Permitted values for device include:

     o   A full device name, such as /dev/tty1.
     o   A simple device name, such as tty1.
     o   A   general   class   of    devices   in   the   form
         attribute=value, which  is equivalent to  naming each
         port with  a stanza  in /etc/ports that  includes the
         specified attribute).

     If you do  not specify a device to  disable, each command
     report the names of currently disabled ports in its set.

       pdisable

     The pdisable command disables the specified port, even if
     a user is  logged on, and makes the  port unavailable for
     log in.  To disable the port, the system ends logger.  If
     you do  not specify  any arguments, pdisable  reports the
     names of all disabled ports.

       phold

     The phold command allows logged-on users to continue, but
     does not allow  any more users to log on.   If you do not
     specify  any arguments,  phold reports  the names  of all
     ports on hold.

FLAGS

     -a With pdisable,  disables all ports that  are currently
        enabled  in  the  /etc/portstatus file.   With  phold,
        holds  all ports  that  are currently  enabled in  the
        /etc/portstatus file.
     -i Reinitializes an existing /etc/portstatus file instead
        of updating the existing  one.  You typically use this
        flag  in  the  /etc/rc command  file  to  re-establish
        default port  enabling before  starting up  the system
        with multiple users.
     -w Makes the command return  immediately rather than wait
        for init to confirm the changes in port status.

EXAMPLES

     1.  To display the names of all ports currently disabled:

           pdisable

     2.  To   disable   all   ports  that   are   enabled   in
         /etc/portstatus, even if users are logged on:

           pdisable  -a

     3.  To disable the work station attached to the /dev/tty8
         port:

           pdisable  tty8

     4.  To disable the work station attached to the /dev/tty2
         and make  the command return immediately  rather than
         wait for init to confirm port status:

           pdisable  -w /dev/tty2

     5.  To list the ports that are currently on hold:

           phold

     6.  To put all "9600" baud ports on hold:

           phold  speed=9600

FILES

     /etc/locks         Contains  lock  files for  pshare  and
                        pdelay.
     /etc/ports         Contains descriptions of known normal,
                        shared, and delayed login ports.
     /etc/portstatus    Contains current status  of each known
                        login port.

RELATED INFORMATION

     The  following commands:   "init"  and "pstart,  penable,
     pshare, pdelay."

     The ports  and portstatus  files in AIX  Operating System
     Technical Reference.