CTLUSER(8) System Manager's Manual 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 performed the command, ctluser will exit with a sta-
tus 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 command 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 commands 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 earlier ``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 sysadmin(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 system.
SEE ALSO luser(1), sysadmin(1), bosskill(8)
19 October 1995 CTLUSER(8)
Check Out this Related Man Page
rcmd(3x)rcmd(3x)Name
rcmd, rresvport, ruserok - routines for returning a stream to a remote command
Syntax
rem = rcmd(ahost, inport, locuser, remuser, cmd, fd2p);
char **ahost;
u_short inport;
char *locuser, *remuser, *cmd;
int *fd2p;
s = rresvport(port);
int *port;
ruserok(rhost, superuser, ruser, luser)
char *rhost;
int superuser;
char *ruser, *luser;
Description
The subroutine is used by the superuser to execute a command on a remote machine using an authentication scheme based on reserved port num-
bers. The subroutine is a routine that returns a descriptor to a socket with an address in the privileged port space. The subroutine is a
routine used by servers to authenticate clients requesting service with All three functions are present in the same file and are used by
the server (among others).
The subroutine looks up the host *ahost using returning -1 if the host does not exist. For further information, see Otherwise *ahost is
set to the standard name of the host and a connection is established to a server residing at the well-known Internet port inport.
If the call succeeds, a socket of type SOCK_STREAM is returned to the caller and given to the remote command as stdin and stdout. If fd2p
is nonzero, then an auxiliary channel to a control process will be set up, and a descriptor for it will be placed in *fd2p. The control
process will return diagnostic output from the command (unit 2) on this channel, and will also accept bytes on this channel as being UNIX
signal numbers, to be forwarded to the process group of the command. If fd2p is 0, then the stderr (unit 2 of the remote command) will be
made the same as the stdout and no provision is made for sending arbitrary signals to the remote process, although you may be able to get
its attention by using out-of-band data.
The protocol is described in detail in
The subroutine is used to obtain a socket with a privileged address bound to it. This socket is suitable for use by and several other rou-
tines. Privileged addresses consist of a port in the range 0 to 1023. Only the superuser is allowed to bind an address of this sort to a
socket.
The subroutine takes a remote host's name, as returned by a routine, two user names and a flag indicating if the local user's name is the
superuser. It then checks the files and in the user's home directory to see if the request for service is allowed. A 0 is returned if the
machine name is listed in the file, or the host and remote user name are found in the file. Otherwise returns -1. If the superuser flag
is 1, the checking of the file is bypassed.
See Alsorlogin(1c), rsh(1c), gethostent(3n), rexec(3x), rexecd(8c), rlogind(8c), rshd(8c)rcmd(3x)