SXTALLOC
Section: Environments, Tables, and Troff Macros (7)
Updated: Edinburgh Univ, June 6 1986
Index
Return to Main Contents
NAME
sxtalloc - allocate/deallocate sxt channels
SYNOPSIS
/usr/lib/ssh/sxtalloc
/usr/lib/ssh/sxtalloc ttyname status
DESCRIPTION
When called with no parameters,
sxtalloc
finds a non-busy sxt channel-zero in /dev/sxt
and chowns all its subchannels to the real user-id of the caller
so that the sxt is then available for use by that user.
It replaces the users original terminal name in the
utmp
file with the new sxt device.
It prints the name of the original terminal on the standard output.
If called with two parameters, it attempts to undo the damage caused by
allocating the device. It replaces the sxt name in the
utmp
file with the
ttyname
parameter, and exits with exit-status
status.
Checks are made that you are entitled to have
ttyname
as your terminal.
The use of
sxtalloc
may be restricted to certain usernames by creating files
sxt.allow
or
sxt.deny
in the directory
/usr/lib/ssh.
If an
allow
file exists, then only those people whose name occurs in this file
are permitted to allocate sxt channels;
if a
deny
file exists, then everyone execept the people named in this file
may allocate sxt's.
If neither exist, then no restrictions on use are in force.
STATUS RETURNS
When allocating an sxt device, it returns status of 0 if it succeeds,
otherwise 1.
When deallocating, it exits with the given exit-status, unless it fails
for some reason (in which case it exits with status 1).
SEE ALSO
ssh(1), sxt(7), utmp(4).
FILES
/usr/lib/ssh/sxtalloc - binary
/dev/sxt/??? - sxt devices
/etc/utmp - utmp file
/usr/lib/ssh/sxt.allow, /usr/lib/ssh/sxt.deny
BUGS
It has to be set-user-id root.
AUTHOR
Simon Brown
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- STATUS RETURNS
-
- SEE ALSO
-
- FILES
-
- BUGS
-
- AUTHOR
-
This document was created by
man2html,
using the manual pages.
Time: 06:31:25 GMT, December 12, 2024