Return to getttyent.3 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man3

Annotation of 43BSDTahoe/man/man3/getttyent.3, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1985 Regents of the University of California.
        !             2: .\" All rights reserved.  The Berkeley software License Agreement
        !             3: .\" specifies the terms and conditions for redistribution.
        !             4: .\"
        !             5: .\"    @(#)getttyent.3 6.4 (Berkeley) 5/20/86
        !             6: .\"
        !             7: .TH GETTTYENT 3  "May 20, 1986"
        !             8: .UC 6
        !             9: .SH NAME
        !            10: getttyent, getttynam, setttyent, endttyent \- get ttys file entry
        !            11: .SH SYNOPSIS
        !            12: .nf
        !            13: .B #include <ttyent.h>
        !            14: .PP
        !            15: .B struct ttyent *getttyent()
        !            16: .PP
        !            17: .B struct ttyent *getttynam(name)
        !            18: .B char *name;
        !            19: .PP
        !            20: .B setttyent()
        !            21: .PP
        !            22: .B endttyent()
        !            23: .fi
        !            24: .SH DESCRIPTION
        !            25: .I Getttyent,
        !            26: and
        !            27: .I getttynam
        !            28: each return a pointer to an object with the
        !            29: following structure
        !            30: containing the broken-out
        !            31: fields of a line from the tty description file.
        !            32: .RS
        !            33: .PP
        !            34: .nf
        !            35: .so /usr/include/ttyent.h
        !            36: .ft R
        !            37: .ad
        !            38: .fi
        !            39: .RE
        !            40: .PP
        !            41: .IP ty_name \w'ty_comment'u+3
        !            42: is the name of the character-special file in the directory ``/dev".
        !            43: For various reasons, it must reside in the directory ``/dev".
        !            44: .IP ty_getty
        !            45: is the command (usually
        !            46: .IR getty (8))
        !            47: which is invoked by
        !            48: .I init
        !            49: to initialize tty line characteristics.
        !            50: In fact, any arbitrary command can be used;
        !            51: a typical use is to initiate a terminal emulator in a window system.
        !            52: .IP ty_type
        !            53: is the name of the default terminal type connected to this tty line. This
        !            54: is typically a name from the
        !            55: .IR termcap (5)
        !            56: data base.
        !            57: The environment variable `TERM' is initialized with this name by
        !            58: .IR getty (8)
        !            59: or
        !            60: .IR login (1).
        !            61: .IP ty_status
        !            62: is a mask of bit fields which indicate various actions to be allowed on this
        !            63: tty line. The following is a description of each flag.
        !            64: .RS
        !            65: .IP TTY_ON \w'TTY_SECURE'u+3
        !            66: Enables logins (i.e.,
        !            67: .IR init (8)
        !            68: will start the specified ``getty" command
        !            69: on this entry).
        !            70: .IP TTY_SECURE
        !            71: Allows root to login on this terminal. Note that `TTY_ON' must be included
        !            72: for this to be useful.
        !            73: .RE
        !            74: .IP ty_window
        !            75: is the command to execute for a window system
        !            76: associated with the line.  The window system will be started before
        !            77: the command specified in the
        !            78: .I ty_getty
        !            79: entry is executed.
        !            80: If none is specified, this will be null.
        !            81: .IP ty_comment
        !            82: is the trailing comment field, if any; a leading delimiter and white space
        !            83: will be removed.
        !            84: .PP
        !            85: .I Getttyent
        !            86: reads the next
        !            87: line from the ttys file, opening the file if necessary;
        !            88: .I setttyent
        !            89: rewinds the file;
        !            90: .I endttyent
        !            91: closes it.
        !            92: .PP
        !            93: .I Getttynam
        !            94: searches from the beginning of the file until a matching
        !            95: .I name
        !            96: is found
        !            97: (or until EOF is encountered).
        !            98: .SH FILES
        !            99: /etc/ttys
        !           100: .SH "SEE ALSO"
        !           101: login(1), ttyslot(3), ttys(5), gettytab(5), termcap(5), getty(8), init(8)
        !           102: .SH DIAGNOSTICS
        !           103: Null pointer
        !           104: (0) returned on EOF or error.
        !           105: .SH BUGS
        !           106: All information
        !           107: is contained in a static area
        !           108: so it must be copied if it is
        !           109: to be saved.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.