xref: /illumos-gate/usr/src/cmd/bnu/Devices (revision 7c478bd9)
1*7c478bd9Sstevel@tonic-gate#
2*7c478bd9Sstevel@tonic-gate# Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
3*7c478bd9Sstevel@tonic-gate# Use is subject to license terms.
4*7c478bd9Sstevel@tonic-gate#
5*7c478bd9Sstevel@tonic-gate# CDDL HEADER START
6*7c478bd9Sstevel@tonic-gate#
7*7c478bd9Sstevel@tonic-gate# The contents of this file are subject to the terms of the
8*7c478bd9Sstevel@tonic-gate# Common Development and Distribution License, Version 1.0 only
9*7c478bd9Sstevel@tonic-gate# (the "License").  You may not use this file except in compliance
10*7c478bd9Sstevel@tonic-gate# with the License.
11*7c478bd9Sstevel@tonic-gate#
12*7c478bd9Sstevel@tonic-gate# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
13*7c478bd9Sstevel@tonic-gate# or http://www.opensolaris.org/os/licensing.
14*7c478bd9Sstevel@tonic-gate# See the License for the specific language governing permissions
15*7c478bd9Sstevel@tonic-gate# and limitations under the License.
16*7c478bd9Sstevel@tonic-gate#
17*7c478bd9Sstevel@tonic-gate# When distributing Covered Code, include this CDDL HEADER in each
18*7c478bd9Sstevel@tonic-gate# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
19*7c478bd9Sstevel@tonic-gate# If applicable, add the following below this CDDL HEADER, with the
20*7c478bd9Sstevel@tonic-gate# fields enclosed by brackets "[]" replaced with your own identifying
21*7c478bd9Sstevel@tonic-gate# information: Portions Copyright [yyyy] [name of copyright owner]
22*7c478bd9Sstevel@tonic-gate#
23*7c478bd9Sstevel@tonic-gate# CDDL HEADER END
24*7c478bd9Sstevel@tonic-gate#
25*7c478bd9Sstevel@tonic-gate#ident	"%Z%%M%	%I%	%E% SMI"
26*7c478bd9Sstevel@tonic-gate
27*7c478bd9Sstevel@tonic-gate# Some sample entries:
28*7c478bd9Sstevel@tonic-gate# NOTE - all lines must have at least 5 fields
29*7c478bd9Sstevel@tonic-gate#    use '-' for unused fields
30*7c478bd9Sstevel@tonic-gate# The Devices file is used in conjunction with the Dialers file.
31*7c478bd9Sstevel@tonic-gate# Types that appear in the 5th field must be either built-in
32*7c478bd9Sstevel@tonic-gate#  functions (801, Sytek, TCP, Unetserver, DK)
33*7c478bd9Sstevel@tonic-gate#  or standard functions whose name appears in the first
34*7c478bd9Sstevel@tonic-gate#  field in the Dialers file.
35*7c478bd9Sstevel@tonic-gate# Two escape characters may appear in this file:
36*7c478bd9Sstevel@tonic-gate# - \D which means don't translate the phone #/token
37*7c478bd9Sstevel@tonic-gate# - \T translate the phone #/token using the Dialcodes file
38*7c478bd9Sstevel@tonic-gate# Both refer to the phone number field in the Systems file (field 5)
39*7c478bd9Sstevel@tonic-gate# \D should always be used with entries in the Dialers file, since the
40*7c478bd9Sstevel@tonic-gate# Dialers file can contain a \T to expand the number if necessary.
41*7c478bd9Sstevel@tonic-gate# \T should only be used with built-in functions that require expansion
42*7c478bd9Sstevel@tonic-gate# NOTE: - if a phone number is expected and a \D or \T is not present
43*7c478bd9Sstevel@tonic-gate#	a \T is used for a built-in, and \D is used for an entry
44*7c478bd9Sstevel@tonic-gate#	referencing the Dialers file. (see examples below)
45*7c478bd9Sstevel@tonic-gate#
46*7c478bd9Sstevel@tonic-gate#
47*7c478bd9Sstevel@tonic-gate# ---Standard modem line
48*7c478bd9Sstevel@tonic-gate# ACU cua/b - 2400 hayes
49*7c478bd9Sstevel@tonic-gate# or
50*7c478bd9Sstevel@tonic-gate# ACU cua/b - 2400 hayes \D
51*7c478bd9Sstevel@tonic-gate#
52*7c478bd9Sstevel@tonic-gate# ---A direct line so 'cu -lcua/b' will work
53*7c478bd9Sstevel@tonic-gate# Direct cua/b - 9600 direct
54*7c478bd9Sstevel@tonic-gate#
55*7c478bd9Sstevel@tonic-gate# ---A ventel modem on a develcon switch (vent is the token given to
56*7c478bd9Sstevel@tonic-gate#	the develcon to reach the ventel modem)
57*7c478bd9Sstevel@tonic-gate# ACU cua/b - 1200 develcon vent ventel
58*7c478bd9Sstevel@tonic-gate# ACU cua/b - 1200 develcon vent ventel \D
59*7c478bd9Sstevel@tonic-gate#
60*7c478bd9Sstevel@tonic-gate# ---To reach a system on the local develcon switch
61*7c478bd9Sstevel@tonic-gate# Develcon cua/b - Any develcon \D
62*7c478bd9Sstevel@tonic-gate#
63*7c478bd9Sstevel@tonic-gate# ---Access a direct connection to a system
64*7c478bd9Sstevel@tonic-gate# systemx term/00 - Any direct
65*7c478bd9Sstevel@tonic-gate#
66*7c478bd9Sstevel@tonic-gate# where the Systems file looks like
67*7c478bd9Sstevel@tonic-gate# systemx Any systemx 1200 unused  "" in:-\r\d-in: nuucp word: nuucp
68*7c478bd9Sstevel@tonic-gate#	(The third field in Systems matches the first field in Devices)
69*7c478bd9Sstevel@tonic-gate#
70*7c478bd9Sstevel@tonic-gate# ---To connect to any system on the DATAKIT VCS network
71*7c478bd9Sstevel@tonic-gate# DK DK 0 Any DK \D
72*7c478bd9Sstevel@tonic-gate#
73*7c478bd9Sstevel@tonic-gate# ---To connect to a system on a Datakit in nj/ho
74*7c478bd9Sstevel@tonic-gate# DKho - uucp Any DK nj/ho/\D
75*7c478bd9Sstevel@tonic-gate#
76*7c478bd9Sstevel@tonic-gate# ---To use an ACU that is connected to Datakit that DK does not understand
77*7c478bd9Sstevel@tonic-gate#	how to talk to directly
78*7c478bd9Sstevel@tonic-gate# ACU - 0 Any DK vent ventel \D
79*7c478bd9Sstevel@tonic-gate#
80*7c478bd9Sstevel@tonic-gate# ---To use a dialer that the Datakit understands how to chat with
81*7c478bd9Sstevel@tonic-gate#	This is a special case where the translation must be done by the
82*7c478bd9Sstevel@tonic-gate#	Devices file processing.
83*7c478bd9Sstevel@tonic-gate# ACU DKacu 0 Any DK py/garage/door.\T
84*7c478bd9Sstevel@tonic-gate#
85*7c478bd9Sstevel@tonic-gate
86*7c478bd9Sstevel@tonic-gateTCP,et - - Any TCP -
87*7c478bd9Sstevel@tonic-gate
88*7c478bd9Sstevel@tonic-gate########	AT&T Transport Interface
89*7c478bd9Sstevel@tonic-gate#
90*7c478bd9Sstevel@tonic-gate# ---To use a STREAMS network that conforms to the AT&T Transport Interface
91*7c478bd9Sstevel@tonic-gate#	with a direct connection to login service (i.e., without
92*7c478bd9Sstevel@tonic-gate#	explicitly using the Network Listener Service dial script):
93*7c478bd9Sstevel@tonic-gate#
94*7c478bd9Sstevel@tonic-gate# networkx,eg devicex - - TLIS \D
95*7c478bd9Sstevel@tonic-gate#
96*7c478bd9Sstevel@tonic-gate#	The Systems file entry looks like:
97*7c478bd9Sstevel@tonic-gate#
98*7c478bd9Sstevel@tonic-gate# systemx Any networkx - addressx in:--in: nuucp word: nuucp
99*7c478bd9Sstevel@tonic-gate#
100*7c478bd9Sstevel@tonic-gate#	You must replace systemx, networkx, addressx, and devicex with system
101*7c478bd9Sstevel@tonic-gate#	name, network name, network address and network device, respectively.
102*7c478bd9Sstevel@tonic-gate#	For example, entries for machine "sffoo" on a STARLAN NETWORK might
103*7c478bd9Sstevel@tonic-gate#	look like:
104*7c478bd9Sstevel@tonic-gate#		sffoo Any STARLAN - sffoo in:--in: nuucp word: nuucp
105*7c478bd9Sstevel@tonic-gate#	and:
106*7c478bd9Sstevel@tonic-gate#		STARLAN,eg starlan - - TLIS \D
107*7c478bd9Sstevel@tonic-gate#
108*7c478bd9Sstevel@tonic-gate# ---To use a STREAMS network that conforms to the AT&T Transport Interface
109*7c478bd9Sstevel@tonic-gate#	and that uses the Network Listener Service dial script to negotiate
110*7c478bd9Sstevel@tonic-gate#	for a server:
111*7c478bd9Sstevel@tonic-gate#
112*7c478bd9Sstevel@tonic-gate# networkx,eg devicex - - TLIS \D nls
113*7c478bd9Sstevel@tonic-gate#
114*7c478bd9Sstevel@tonic-gate#
115*7c478bd9Sstevel@tonic-gate# ---To use a non-STREAMS network that conforms to the AT&T Transport
116*7c478bd9Sstevel@tonic-gate#	Interface and that uses the Network Listener Service dial script
117*7c478bd9Sstevel@tonic-gate#	to negotiate for a server:
118*7c478bd9Sstevel@tonic-gate#
119*7c478bd9Sstevel@tonic-gate# networkx,eg devicex - - TLI \D nls
120*7c478bd9Sstevel@tonic-gate#
121*7c478bd9Sstevel@tonic-gate########
122*7c478bd9Sstevel@tonic-gate#
123*7c478bd9Sstevel@tonic-gate#
124*7c478bd9Sstevel@tonic-gate# NOTE: blank lines and lines that begin with a <space>, <tab>, or # are
125*7c478bd9Sstevel@tonic-gate#		ignored.
126*7c478bd9Sstevel@tonic-gate#	protocols can be specified as a comma-subfield of the device type
127*7c478bd9Sstevel@tonic-gate#		either in the Devices file (where device type is field 1)
128*7c478bd9Sstevel@tonic-gate#		or in the Systems file (where it is field 3).
129*7c478bd9Sstevel@tonic-gate#
130*7c478bd9Sstevel@tonic-gate########
131*7c478bd9Sstevel@tonic-gate#
132*7c478bd9Sstevel@tonic-gateACU cua/b - Any hayes
133*7c478bd9Sstevel@tonic-gateDirect cua/b - Any direct
134