Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

ttyaction(3) [netbsd man page]

TTYACTION(3)						   BSD Library Functions Manual 					      TTYACTION(3)

NAME
ttyaction -- ttyaction utility function LIBRARY
System Utilities Library (libutil, -lutil) SYNOPSIS
#include <util.h> int ttyaction(char *ttyname, char *action, char *username); DESCRIPTION
The ttyaction() function is used by login(1), getty(8), telnetd(8) and rlogind(8) to execute site-specific commands when a login session begins and ends. The ttyaction() function scans the /etc/ttyaction file for any records that match the current ttyname and action parameters, and for each matching record, runs the shell command shown in that record. The record format is described in ttyaction(5). The parameter username is the name of the new owner of the ttyname device. Note that the ttyname parameter may be passed as a fully qualified pathname, and the ttyaction() function will skip the leading "/dev/" part of the string. (This is a convenience for login and getty.) RETURN VALUES
ttyaction() returns the status of the last command it executed, or zero if no matching commands were found. FILES
/dev/* /etc/ttyaction SEE ALSO
ttyaction(5) AUTHORS
Gordon W. Ross <gwr@NetBSD.org>, Chris G. Demetriou <cgd@NetBSD.org>, Ty Sarna <tsarna@NetBSD.org>. BUGS
There should be some other mechanism to allow selection of different access control policies on a per-line basis. It has been suggested that the same ttyaction() mechanism should also be used for determining access control, but it was decided (after much discussion) that ttyaction() should only describe actions to be performed after the system has decided to change the ownership of some tty. Access control policies will be handled by a separate mechanism. BSD
May 4, 2010 BSD

Check Out this Related Man Page

GETTY(8)						    BSD System Manager's Manual 						  GETTY(8)

NAME
getty, uugetty -- set terminal modes for system access SYNOPSIS
getty [type [tty]] uugetty [type [tty]] DESCRIPTION
The getty program is called by init(8) to open and initialize the tty line, read a login name, and invoke login(1). The devices on which to run getty are normally determined by ttys(5). The getty program can also recognize a Point to Point Protocol (PPP) negotiation, and, if the pp attribute in gettytab(5) is set, invoke the program given by that string, e.g., pppd(8), instead of login(1). This makes it possible to use a single serial port for either a "shell" account with command line interface, or a PPP network link. The argument tty is the special device file in /dev to open for the terminal (for example, "ttyh0"). If there is no argument or the argument is '-', the tty line is assumed to be open as file descriptor 0. The type argument can be used to make getty treat the terminal line specially. This argument is used as an index into the gettytab(5) data- base, to determine the characteristics of the line. If there is no argument, or there is no such table, the default table is used. If there is no /etc/gettytab a set of system defaults is used. If indicated by the table located, getty will clear the terminal screen, print a ban- ner heading, and prompt for a login name. Usually either the banner or the login prompt will include the system hostname. getty uses the ttyaction(3) facility with an action of "getty" and user "root" to execute site-specific commands when it starts. Most of the default actions of getty can be circumvented, or modified, by a suitable gettytab(5) table. The getty program can be set to timeout after some interval, which will cause dial up lines to hang up if the login name is not entered rea- sonably quickly. The uugetty program is the same, except that it uses pidlock(3) to respect the locks in /var/spool/lock of processes that dial out on that tty. FILES
/etc/gettytab /etc/ttys /var/spool/lock/LCK..ttyXX DIAGNOSTICS
ttyxx: No such device or address. ttyxx: No such file or address. A terminal which is turned on in the ttys(5) file cannot be opened, likely because the requisite lines are either not configured into the system, the associated device was not attached during boot-time system configuration, or the special file in /dev does not exist. SEE ALSO
login(1), ioctl(2), pidlock(3), ttyaction(3), tty(4), gettytab(5), ttys(5), init(8), pppd(8) HISTORY
A getty program appeared in Version 6 AT&T UNIX. BSD
December 12, 1998 BSD
Man Page