1syncinit(1M)            System Administration Commands            syncinit(1M)
2
3
4

NAME

6       syncinit - set serial line interface operating parameters
7

SYNOPSIS

9       /usr/sbin/syncinit device
10            [ [baud_rate] | [keyword=value,]... | [single-word option]]
11
12

DESCRIPTION

14       The  syncinit  utility  allows  the user to modify some of the hardware
15       operating modes common to synchronous serial lines. This can be  useful
16       in  troubleshooting a link, or necessary to the operation of a communi‐
17       cations package.
18
19
20       If run without options, syncinit reports the options as  presently  set
21       on  the  port.  If options are specified, the new settings are reported
22       after they have been made.
23

OPTIONS

25       Options to syncinit normally take the form of a keyword, followed by an
26       equal sign and a value. The exception is that a baud rate may be speci‐
27       fied as a decimal integer by itself. Keywords must begin with the value
28       shown  in  the  options table, but may contain additional letters up to
29       the equal sign. For example,  loop= and loopback= are equivalent.
30
31
32       The following options are supported:
33
34
35
36
37       Keyword     Value      Effect
38       loop        yes        Set the port to  operate  in  internal
39                              loopback  mode.  The receiver is elec‐
40                              trically  disconnected  from  the  DCE
41                              receive  data  input  and  tied to the
42                              outgoing transmit data line.  Transmit
43                              data is available to the DCE. The Dig‐
44                              ital Phase-Locked Loop (DPLL) may  not
45                              be  used  as  a  clock  source in this
46                              mode. If  no  other  clocking  options
47                              have   been   specified,  perform  the
48                              equivalent of txc=baud and rxc=baud.
49                   no         Disable internal loopback mode.  If no
50                              other clocking options have been spec‐
51                              ified,  perform  the   equivalent   of
52                              txc=txc and rxc=rxc.
53       echo        yes        Set  the  port to operate in auto-echo
54                              mode.  The  transmit  data  output  is
55                              electrically   disconnected  from  the
56                              transmitter and tied  to  the  receive
57                              data  input.  Incoming receive data is
58                              still visible.  Use of  this  mode  in
59                              combination  with  local loopback mode
60                              has no value, and should  be  rejected
61                              by  the  device  driver. The auto-echo
62                              mode is useful to make a system become
63                              the  endpoint  of  a  remote  loopback
64                              test.
65                   no         Disable auto-echo mode.
66
67       nrzi        yes        Set the port to operate with NRZI data
68                              encoding.
69                   no         Set  the port to operate with NRZ data
70                              encoding.
71       txc         txc        Transmit clock source will be the  TxC
72                              signal (pin 15).
73                   rxc        Transmit  clock source will be the RxC
74                              signal (pin 17).
75                   baud       Transmit  clock  source  will  be  the
76                              internal baud rate generator.
77                   pll        Transmit clock source will be the out‐
78                              put of the DPLL circuit.
79       rxc         rxc        Receive clock source will be  the  RxC
80                              signal (pin 17).
81                   txc        Receive  clock  source will be the TxC
82                              signal (pin 15).
83                   baud       Receive  clock  source  will  be   the
84                              internal baud rate generator.
85                   pll        Receive  clock source will be the out‐
86                              put of the DPLL circuit.
87       speed       integer    Set the baud rate to integer bits  per
88                              second.
89
90
91
92       There  are  also several single-word options that set one or more para‐
93       maters at a time:
94
95
96
97
98       Keyword                       Equivalent to Options:
99       external                      txc=txc rxc=rxc loop=no
100       sender                        txc=baud rxc=rxc loop=no
101       internal                      txc=pll rxc=pll loop=no
102       stop                          speed=0
103
104

EXAMPLES

106       Example 1 Using syncinit
107
108
109       The following command sets the first CPU port to loop internally, using
110       internal clocking and operating at 38400 baud:
111
112
113         example# syncinit zsh0 38400 loop=yes
114         device: /dev/zsh  ppa: 0
115         speed=38400, loopback=yes, echo=no, nrzi=no, txc=baud, rxc=baud
116
117
118
119
120       The following command sets the same port's clocking, local loopback and
121       baud rate settings to their default values:
122
123
124         example# syncinit zsh0 stop loop=no
125         device: /dev/zsh  ppa: 0
126         speed=0, loopback=no, echo=no, nrzi=no, txc=txc, rxc=rxc
127
128
129

ATTRIBUTES

131       See attributes(5) for descriptions of the following attributes:
132
133
134
135
136       ┌─────────────────────────────┬─────────────────────────────┐
137       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
138       ├─────────────────────────────┼─────────────────────────────┤
139       │Availability                 │SUNWcsu                      │
140       └─────────────────────────────┴─────────────────────────────┘
141

SEE ALSO

143       syncloop(1M), syncstat(1M), intro(2), ioctl(2), attributes(5),  zsh(7D)
144

DIAGNOSTICS

146       device missing minor device number
147
148           The name  device does not end in a decimal number that can be  used
149           as a minor device number.
150
151
152       bad speed: arg
153
154           The  string   arg  that accompanied the  speed= option could not be
155           interpreted as a decimal integer.
156
157
158       Bad arg: arg
159
160           The string  arg did not make sense as an option.
161
162
163       ioctl failure code = errno
164
165           An ioctl(2) system called failed.  The  meaning  of  the  value  of
166           errno may be found in intro(2).
167
168

WARNINGS

170       Do  not use syncinit on an active serial link, unless needed to resolve
171       an error condition. Do not use this command casually or  without  being
172       aware of the consequences.
173
174
175
176SunOS 5.11                        9 Mar 1993                      syncinit(1M)
Impressum