admprocess(1M)                   DG/UX R4.11                  admprocess(1M)


NAME
       admprocess - manage processes

SYNOPSIS
       admprocess -o modify { -p proclist | -t termlist | -u uidlist } -r
                 priority

       admprocess -o signal { -p proclist | -t termlist | -u uidlist } -s
                 signo

       admprocess -o delete { -p proclist | -t termlist | -u uidlist }

       admprocess -o list [ -p proclist | -t termlist | -u uidlist ] [ -lqv
                 ]

DESCRIPTION
       The admprocess command is used to display information about all or
       selected active processes, delete (terminate) processes, send a
       signal to processes, or change the priority of processes.

   Operations
       modify    Change the priority of selected processes.  Only a user
                 with appropriate privilege (see NOTE, below) can improve
                 the priority of a process.

       signal    Send a signal to selected processes.  Any signal can be
                 sent, as specified by the -s option.

       delete    Terminate selected processes.  The process is sent a
                 SIGTERM signal, and if that fails is sent a SIGKILL signal.

       list      Display information about all or selected active processes.
                 The information that is displayed is that of the ps(1)
                 command and is described in its manual entry.

   Options
       -p proclist
                 A process ID, or comma-separated list of process IDs, that
                 are to be selected.

       -t termlist
                 A tty number, or comma-separated list of tty numbers, that
                 are to be selected.

       -u uidlist
                 A user name or login ID, or comma-separated list of user
                 names and login IDs, that are to be selected.

       -r priority
                 The priority value ranges from 0 (top priority) to 39
                 (least priority), with 20 being the usual default.  This
                 value is 20 more that the nice value to be assigned to the
                 process, from which the execution priority is computed.
                 The value is reported using the list operation and the -l
                 option in the column headed NI.

       -s signo  The number of the signal to be sent to the process.  Signal
                 numbers are defined in /usr/include/sys/signal.h.

       -l        Use the long listing, as described for the -l option to
                 ps(1).  The default is to produce a report using the -f
                 option of ps.

       -q        Quiet.  Header lines are omitted from list output.

       -v        Verbose.  Header lines are included in list output.  This
                 option is enabled by default.

       One of the -p, -t, or -u options is required for delete, signal, and
       modify.  The list operation displays information about all processes
       if none of those process selection options are specified.

EXAMPLES
       To show all processes on /dev/tty05, use:

            admprocess -o list -t05

       To terminate process IDs 512 and 514, use:

            admprocess -o delete -p 512,514


OUTPUT
       The output of the list operation is that of the ps(1) command, and is
       explained in that manual entry.  Without the -v option, the output is
       that of ps -f.  With the -v option, the output is that of ps -l.

DIAGNOSTICS
   Exit Codes
        0     The operation was successful.

        1     The operation was unsuccessful.

        2     The operation failed due to access restrictions.

        3     There was an error in the command line.

        4     No processes matched the selection criteria.

SEE ALSO
       ps(1), kill(1), renice(1), sysadm(1M), who(1),
       kill(2), signal(2),
       appropriate_privilege(5).

NOTE
       On a traditional DG/UX system, appropriate privilege is granted by
       having an effective UID of 0 (root).  See the
       appropriate_privilege(5) man page for more information.

       On a system with DG/UX information security, appropriate privilege is
       granted by having one or more specific capabilities enabled in the
       effective capability set of the user.  See the cap_defaults(5) man
       page for more information.



Licensed material--property of copyright holder(s)