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