securettys(4) Kernel Interfaces Manual securettys(4)NAME
securettys - Secure terminal database file
DESCRIPTION
Security Note
The terminal database file used on a trusted system is /etc/auth/system/ttys and is documented in the ttys(4) reference page.
The /etc/securettys file specifies the tty lines that are considered secure and permit logins as root.
Each line in the file contains the pathname of the special file for a terminal. A number sign (#) character can be used for comments. The
following example is typical and allows root to log in from the console, from the X-display, and from tty00: # Terminal lines for root
logins # /dev/console :0 /dev/tty00
If this file does not exist, root can log in only from the console.
To allow root to log in from any pseudoterminal, add the keyword ptys to this file. (This keyword does not require the /dev prefix.)
FILES
Specifies the pathname of the file.
RELATED INFORMATION
Commands: login(1)
Functions: getttyent(3)
Files: ttys(4) delim off
securettys(4)
Check Out this Related Man Page
getttyent(3) Library Functions Manual getttyent(3)NAME
getttyent, getttyent_r, getttynam, getttynam_r, setttyent, setttyent_r, endttyent, endttyent_r - Get a /etc/securettys file entry
LIBRARY
Standard C Library (libc.a)
SYNOPSIS
#include <ttyent.h>
struct ttyent *getttyent ( void );
struct ttyent *getttynam( const char *name);
int setttyent(void);
void endttyent(void);
The following obsolete functions are supported in order to maintain backward compatibility with previous versions of the operating system.
You should not use them in new designs. int getttyent_r( struct ttyent *tte, char *buf, int len, FILE **tty_fp);
int getttynam_r( const char *name, struct ttyent *tte, char *buf, int len);
int setttyent_r( FILE **tty_fp);
void endttyent_r( FILE **tty_fp);
PARAMETERS
Points to the ttyent structure. The ttyent.h header file defines the ttyent structure. Specifies the name of the requested tty descrip-
tion. Is data for the tty. Specifies the length of buf. Specifies a secure ttys file stream.
DESCRIPTION
The getttyent() and getttynam() functions each return a pointer to an object that has the following ttyent fields. These fields describe a
line from the secure tty description file.
The members of the structure include the following: Name of the character-special file. The string "none". The string "none". A mask of
bit fields. The TTY_SECURE flag indicates users with a user ID of 0 (zero) are allowed to log in on this terminal. A NULL pointer A NULL
pointer.
If any of the fields pointing to character strings are unspecified, they are returned as NULL pointers. The field ty_status will be 0
(zero) if root logins are not allowed.
The getttyent() function reads the next line from the tty file, opening the file if necessary. The setttyent() function rewinds the file
if open, or opens the file if it is unopened. The endttyent() function closes any open files.
The getttynam() function searches from the beginning of the file until a matching name is found or until EOF (End-Of-File) is encountered.
NOTES
The getttyent(), setttyent(), endttyent(), and getttynam() functions return a pointer to thread-specific data. Subsequent calls to these
functions from the same thread overwrite this data.
The getttyent_r(), setttyent_r(), endttyent_r(), and getttynam_r() functions are obsolete reentrant versions of these functions. They are
supported in order to maintain backward compatibility with previous versions of the operating system and should not be used in new designs.
Note that you must initialize the *tty_fp parameter to NULL before its first access by any of these functions.
RETURN VALUES
Upon successful completion, the getttyent() and getttynam() functions return a pointer to a ttyent structure. If they fail or reach the
end of the terminal control database file, they return a null pointer.
Upon successful completion, the setttyent() function returns a value of 1. Upon failure, it returns a value of 0 (zero).
Upon successful completion, the getttyent_r() and getttynam_r() functions store the ttyent structure in the location pointed to by tte, and
return a value of 0 (zero). Upon failure, they return a value of -1.
Upon successful completion, the setttyent_r() function returns a value of 0 (zero). Upon failure, it returns a value of -1.
ERRORS
If any of the following conditions occurs, the getttyent_r() or getttynam_r() functions set errno to the corresponding value: The search
failed.
In addition, if any of the following conditions occurs, the getttyent_r() or setttyent_r() functions set errno to the corresponding value:
The tty_fp, tte, or buf parameter is invalid, or the len parameter is too small.
FILES
/etc/securettys Contains the terminal control database file.
RELATED INFORMATION
Commands: login(1)
Files: securettys(4). delim off
getttyent(3)