ttys.conf man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]

TTYS.CONF(5)		    BSD Programmer's Manual		  TTYS.CONF(5)

NAME
     ttys.conf - terminal line configuration file

SYNOPSIS
     /etc/ttys.conf
     /etc/ttys.conf.local

DESCRIPTION
     The /etc/ttys.conf file contains entries referenced by the /etc/ttys file
     as well user/group permissions/restrictions and destination information
     for outgoing calls.  The over all format of the file is defined in the
     cgetent(3) manual page.  Most entries may have more than a single value.
     Values are separated by the | (pipe) symbol.  For example:

     :entry=value1|value2|value3:

     To specify a | use \|.

     Entries which define restrictions or permissions for a given user or
     group are tagged by user-name or group-name.

     The following are the standard entries.  There is no limit on the names
     for new entries.

     allow  A list of the special sequences allowed by this user.  If not de-
	    fined, all special sequences not listed in the restrict entry are
	    allowed.  The special sequences are defined by the map entry for
	    the chosen line.  An example entry might be:

	    :allow=<DIALTONE>|<PAUSE>:

     arguments
	    A list of arguments which should be sent to the scripts defined by
	    the condition, dialer, hangup, and watcher entries.	 The arguments
	    are names of entries for which the values should be passed.	 For
	    example:

	    :arguments=dte-speeds|term|line:

	    might cause the following arguments to be sent to a script

	    -dte-speeds 9600 -term unknown -line tty01

     auth   The type of authentication for this line.  This type is used as
	    auth-type in the /etc/login.conf file.

     banner
	    Banner to be displayed by the login(8) program.

     calltype
	    Types of calls allowed on this line, or by this user or group.
	    The special type DIRECT implies the request is for the raw line
	    itself with no dialing or setup.  Other types of calls are defined
	    by the /etc/dialer.rules file.  By convention these are: LOCAL,
	    NATIONAL, INTL, ASSISTED-NATIONAL, and ASSISTED-INTL.

     command
	    The name of the command to execute when carrier is enabled on the
	    line.  By default this is /usr/bin/login.

     compression
	    Types of automatic data compression available from the modem.
	    While this value may be used to help select a line, the default
	    dialing scripts provided with the system do not attempt to use
	    this information.

     condition
	    Script called to condition a modem to accept incoming calls.  The
	    script should leave the modem in such a state that it will auto-
	    matically answer incoming calls.  The synopsis of the script is:

	    condition [-f file] [arguments]

	    The file argument is the file associated with the line, typically
	    /dev/fd/xx. The arguments are the arguments specified by the
	    arguments entry.

     cost   The relative cost of the line.  If multiple lines match the re-
	    quest, and a speed was requested, the line with the lowest cost is
	    used.  By default the cost of a line is the maximum value in the
	    speed entry for the line.  If the request does not specify a
	    speed, the lowest cost line with the highest available speed is
	    used.

     dce-speeds
	    The DCE speeds available for this modem.  The DCE speed is the
	    speed the modem communicates with the serial line.

     destination
	    The name of a single entry in the database to merge with the re-
	    quest.  This entry only has use in a request and has no effects on
	    line definitions.  A destination typically includes the phone num-
	    ber or numbers as well as the optimum dialing speeds.

     dialer
	    Script to dial a number on a modem.	 The synopsis of the script
	    is:

	    dialer [-f file] [arguments]

	    The file argument is the file associated with the line, typically
	    /dev/fd/xx. The arguments are the union of the arguments specified
	    by the arguments entry and entry which matched between the request
	    and the entry for the line.

     dialin
	    This line is marked to accept incoming calls.  This is used for
	    both hardwired and modem connected lines.

     dialout
	    This line is marked to allow outgoing calls.  See gettyd(8) for
	    more information.

     dte-speeds
	    The DTE speeds available for this line (or the dte speeds de-
	    sired).  The DTE speed is the speed at which the serial line com-
	    municates with the modem.  When both dte-speeds and dce-speeds are
	    specified, the actual set of DTE speeds is the intersection of
	    dte-speeds and dce-speeds.

     error-correction
	    The types of error correction available from the modem.  While
	    this value may be used to help select a line, the default dialing
	    scripts provided with the system do not attempt to use this infor-
	    mation.

     flow   The types of flow control available from the modem.	 While this
	    value may be used to help select a line, the default dialing
	    scripts provided with the system do not attempt to use this infor-
	    mation.  Use the flowcontrol field to specify a specific type of
	    flow control.

     flowcontrol
	    Without a value, enable hardware flow control.  If a value is
	    specified it must be one of:

	    hardware
		   Enable hardware flow control for this line.	(The same as
		   not specifying a value).  May also be abbreviated as hw.

	    none   No flow control is enabled.

	    software
		   Enable software flow control for this line.	May also be
		   abbreviated as sw.

     groups
	    A list of groups allowed to access this line.

     hangup
	    A script similar to condition, however, it simply assures the
	    phone is hung up and the line is ready for another dialout ses-
	    sion.  It is only called on dialout lines.	The synopsis for
	    hangup is the same as that of the condition script.

     hcondition
     hdial
     hhangup
     hinit
     hquiet
     hreset
	    See the hayes(8) manual page for details on these fields.

     issue  The name of a file to be displayed after the login(8) program
	    prints the login banner (specified by the banner field.)  No er-
	    rors are generated if the file pointed to does not exist.

     line   The list of devices to select from for this connection.  It may
	    only be specified as part of a request (or in a destination defi-
	    nition).

     manager
	    The name of the program which manages this line.  This does not
	    cause the named program to be run.	It is used by a program when
	    it is searching for entries which it should control.  If this has
	    no value, or is specified to be none, then the line is not man-
	    aged.  Enabled lines normally have the value of gettyd, or init
	    for compatability with older systems.

     map    A mapping of special sequences to strings used by the modem.  Each
	    entry is of the form: <sequence>string. For example, a hayes com-
	    patible modem might have the entry:

	    :map=<FLASH>!|<TONE>T|<PULSE>P|<DIALTONE>W|<REVERSE>~
		 |<SILENCE>@|<PAUSE>,:

     modemcontrol
	    Enable modem control for this line.

     modemtype
	    A verbose description of the modem.	 In general its presence indi-
	    cates this entry is describing a modem.

     modulation
	    The types of modulation (i.e., bell103, v.21, v.34...) available
	    from the modem.  While this value may be used to help select a
	    line, the default dialing scripts provided with the system do not
	    attempt to use this information.

     number
	    The list of phone numbers to dial.	Phone number may be of the
	    form @name in which case name is looked up in /etc/phones. Vari-
	    able expansion, represented by {variable}, is performed on the fi-
	    nal number.	 Variables are defined in the /etc/dialer.rules file.
	    (See dialer.rules(5).)  Special sequences are represented as
	    <SPECIAL>. (See the map entry and dialer.rules(5).)

     porttype
	    A verbose description of the type of serial port.  In general its
	    presence indicates this entry is describing a serial port.

     ppp    Program called by login(8) when PPP LCP negotiation is detected.
	    This defaults to the ppp(8) program.

     pppname
	    Name passed to the ppp(8) program by login(8) when PPP LCP negoti-
	    ation is detected.	This defaults to ppp_direct.

     required
	    A list of fields that must be present in the request in order to
	    match this entry.  A common example might be:

	    :required=number:

     restrict
	    A list of special sequences not allowed.

     secure
	    This line is marked as secure.  A secure line allows direct root
	    logins.

     speaker
	    Describes the various settings the speaker may be set to.  While
	    this value may be used to help select a line, the default dialing
	    scripts provided with the system do not attempt to use this infor-
	    mation.

     speed  The various modulation speeds available with the connected modem.
	    The modulation speed is the speed at which the modems communicate.
	    The is different from dte-speeds and dce-speeds.

     stty-modes
	    Additional modes to set on the line.  See stty(1) for a list of
	    modes.

     term   The default terminal type for this line.

     users  A list of users allowed to access this line.

     uucplocking
	    This boolean option indicates of uucp style locking needs to be
	    done on this line.

     verbose
	    Request the dialer to be verbose with what it is doing.

     volume
	    Describes the volume settings that may be set for the modem.
	    While this value may be used to help select a line, the default
	    dialing scripts provided with the system do not attempt to use

	    this information.

     watcher
	    A script similar to condition, however, it does not return unless
	    there was an error in initializing the modem.  Normally it answers
	    the phone and directly starts the getty program specified.	The
	    synopsis for watcher is the same as that of the condition script.

     window
	    The name of the window manager to use on this line.	 This is ar-
	    chaic and is only present for backwards compatibility.  It is only
	    used by init(8).

SEE ALSO
     dialer.rules(5),  ttys(5),	 gettyd(8),  gettystat(8),  hayes-
     condition(8),  init(8),  login(8)

BSDI BSD/OS		       October 16, 1997				     5
[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net