CTLUSER(8)                                             CTLUSER(8)



NAME
       ctluser - control lusers

SYNOPSIS
       ctluser [ -h ] [ -m ] command [ argument...  ]

DESCRIPTION
       Ctluser  sends a message to the control channel of a given
       luser(8) This command can only be run by the sysadmin(1)

       In the normal mode of behavior, the message is sent to the
       luser's  brain,  which  then performs the requested action
       and sends back a reply with a text message  and  the  exit
       code  for ctluser.  If the luser's brain successfully per­
       formed the command, ctluser will exit  with  a  status  of
       zero and print the reply on standard output.

       The  ``-m'' flag is used to display an MPEG of the results
       of the given command on the  console  of  the  sysadmin(1)
       Note that this requires the sysadmin(1) to be running an X
       server.

       To see a command summary, use the ``-h'' flag.  If a  com­
       mand  is  included when ctluser is invoked with the ``-h''
       flag, then only the usage for that command will be  given.

       The complete list of commands follows.  Note that all com­
       mands have a fixed number of arguments.   If  a  parameter
       can be an empty string, then it is necessary to specify it
       as two adjacent quotes, like "".

       addhist <entry>
              Add an entry to the luser's employment record.

       allow reason
              Allow a luser to use  the  computer  system  again.
              The reason must be the same text given with an ear­
              lier ``reject'' command.  Note that this command is
              currently not implemented.

       begin name
              Begin  a  new  luser(1)  with the given file.  Note
              that this command is currently not implemented.

       cancel pid
              Causes a process of a luser to be killed

       changegroup group
              Changes a luser from their current workgroup to the
              one specified.

       checkfile
              Forces a user to return to a paper based system

       drop   Causes  a  large mass to drop onto the luser from a
              great height.

       flushlogs
              Destorys all logs of the actions done by the sysad­
              min(1) to the luser.

       go reason
              The luser is fired for the given reason.

       hangup Makes the luser hang themselves

       mode   Displays the operating mode of the luser

       newgroup group
              Causes a luser to make their own newgroup up

       pause thought
              Makes  the luser pause for the given thought.  Note
              that this may cause some lusers to crash

       shutdown reason
              Makes the luser shutdown. This is  essentially  the
              same as killing them

       signal sig
              Sends the given signal to the luser

       throttle reason
              Causes the luser to throttle themselves

       trace item flag
              Gives the sysadmin(1) information on what the luser
              is doing.


BUGS
       Ctluser sometimes has the effect of lusers complaining the
       to  management.  The  use of bosskill(8) maybe required at
       this point.

HISTORY
       Written by Simon Burr <simes@tcp.co.uk>.  Based  upon  the
       manual  page for ctlinnd(8), part of the InterNetNews sys­
       tem.

SEE ALSO
       luser(1), sysadmin(1), bosskill(8)



                         19 October 1995               CTLUSER(8)

By Olli's man-to-html utility, Sat Jan 19 19:57:40 CET 2002.