share/man/man8/syncinit.8

   1 '\" te
   2 .\" Copyright (c) 1993, Sun Microsystems, Inc.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH SYNCINIT 8 "Nov 26, 2017"
   7 .SH NAME
   8 syncinit \- set serial line interface operating parameters
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/sbin/syncinit\fR \fIdevice\fR
  13      [ [\fIbaud_rate\fR] | [\fIkeyword\fR=\fIvalue\fR,]... | [\fIsingle-word\fR \fIoption\fR]]
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .LP
  18 The \fBsyncinit\fR utility allows the user to modify some of the hardware
  19 operating modes common to synchronous serial lines. This can be useful in
  20 troubleshooting a link, or necessary to the operation of a communications
  21 package.
  22 .sp
  23 .LP
  24 If run without options, \fBsyncinit\fR reports the options as presently set on
  25 the port. If options are specified, the new settings are reported after they
  26 have been made.
  27 .SH OPTIONS
  28 .LP
  29 Options to \fBsyncinit\fR normally take the form of a keyword, followed by an
  30 equal sign and a value. The exception is that a baud rate may be specified as a
  31 decimal integer by itself. Keywords must begin with the value shown in the
  32 options table, but may contain additional letters up to the equal sign. For
  33 example,  \fBloop=\fR and \fBloopback=\fR are equivalent.
  34 .sp
  35 .LP
  36 The following options are supported:
  37 .sp
  38
  39 .sp
  40 .TS
  41 l l l
  42 l l l .
  43 \fBKeyword\fR   \fBValue\fR     \fBEffect\fR
  44 \fBloop\fR      yes     T{
  45 Set the port to operate in \fBinternal loopback\fR mode. The receiver is electrically disconnected from the DCE receive data input and tied to the outgoing transmit data line. Transmit data is available to the DCE. The Digital Phase-Locked Loop (DPLL) may not be used as a clock source in this mode. If no other clocking options have been specified, perform the equivalent of \fBtxc=baud\fR and \fBrxc=baud\fR.
  46 T}
  47         no      T{
  48 Disable internal loopback mode.  If no other clocking options have been specified, perform the equivalent of \fBtxc=txc\fR and \fBrxc=rxc\fR.
  49 T}
  50 \fBecho\fR      yes     T{
  51 Set the port to operate in \fBauto-echo\fR mode.  The transmit data output is electrically disconnected from the transmitter and tied to the receive data input. Incoming receive data is still visible.  Use of this mode in combination with local loopback mode has no value, and should be rejected by the device driver. The \fBauto-echo\fR mode is useful to make a system become the endpoint of a remote loopback test.
  52 T}
  53         no      Disable \fBauto-echo\fR mode.
  54 \fBnrzi\fR      yes     T{
  55 Set the port to operate with \fBNRZI\fR data encoding.
  56 T}
  57         no      T{
  58 Set the port to operate with \fBNRZ\fR data encoding.
  59 T}
  60 \fBtxc\fR       \fBtxc\fR       T{
  61 Transmit clock source will be the \fBTxC\fR signal (pin 15).
  62 T}
  63         \fBrxc\fR       T{
  64 Transmit clock source will be the \fBRxC\fR signal (pin 17).
  65 T}
  66         \fBbaud \fR     T{
  67 Transmit clock source will be the internal \fBbaud rate generator\fR.
  68 T}
  69         \fBpll\fR       T{
  70 Transmit clock source will be the output of the \fBDPLL\fR circuit.
  71 T}
  72 \fBrxc\fR       \fBrxc\fR       T{
  73 Receive clock source will be the \fBRxC\fR signal (pin 17).
  74 T}
  75         \fBtxc\fR       T{
  76 Receive clock source will be the \fBTxC\fR signal (pin 15).
  77 T}
  78         \fBbaud\fR      T{
  79 Receive clock source will be the internal \fBbaud rate generator\fR.
  80 T}
  81         \fBpll\fR       T{
  82 Receive clock source will be the output of the \fBDPLL\fR circuit.
  83 T}
  84 \fBspeed\fR     \fIinteger\fR   T{
  85 Set the baud rate to \fIinteger\fR bits per second.
  86 T}
  87 .TE
  88
  89 .sp
  90 .LP
  91 There are also several single-word options that set one or more parameters at a
  92 time:
  93 .sp
  94
  95 .sp
  96 .TS
  97 l l
  98 l l .
  99 \fBKeyword\fR   \fBEquivalent to Options:\fR
 100 \fBexternal\fR  \fBtxc=txc rxc=rxc loop=no\fR
 101 \fBsender\fR    \fBtxc=baud rxc=rxc loop=no\fR
 102 \fBinternal\fR  \fBtxc=pll rxc=pll loop=no\fR
 103 \fBstop\fR      \fBspeed=0\fR
 104 .TE
 105
 106 .SH EXAMPLES
 107 .LP
 108 \fBExample 1 \fRUsing \fBsyncinit\fR
 109 .sp
 110 .LP
 111 The following command sets the first CPU port to loop internally, using
 112 internal clocking and operating at 38400 baud:
 113
 114 .sp
 115 .in +2
 116 .nf
 117 example# syncinit zsh0 38400 loop=yes
 118 device: /dev/zsh  ppa: 0
 119 speed=38400, loopback=yes, echo=no, nrzi=no, txc=baud, rxc=baud
 120 .fi
 121 .in -2
 122 .sp
 123
 124 .sp
 125 .LP
 126 The following command sets the same port's clocking, local loopback and baud
 127 rate settings to their default values:
 128
 129 .sp
 130 .in +2
 131 .nf
 132 example# syncinit zsh0 stop loop=no
 133 device: /dev/zsh  ppa: 0
 134 speed=0, loopback=no, echo=no, nrzi=no, txc=txc, rxc=rxc
 135 .fi
 136 .in -2
 137 .sp
 138
 139 .SH SEE ALSO
 140 .LP
 141 \fBsyncloop\fR(8), \fBsyncstat\fR(8), \fBIntro\fR(2), \fBioctl\fR(2),
 142 \fBattributes\fR(5), \fBzsh\fR(7D)
 143 .SH DIAGNOSTICS
 144 .ne 2
 145 .na
 146 \fB\fIdevice\fR\fB missing minor device number\fR\fR
 147 .ad
 148 .sp .6
 149 .RS 4n
 150 The name  \fIdevice\fR does not end in a decimal number that can be used as a
 151 minor device number.
 152 .RE
 153
 154 .sp
 155 .ne 2
 156 .na
 157 \fB\fBbad speed: \fR\fIarg\fR\fR
 158 .ad
 159 .sp .6
 160 .RS 4n
 161 The string  \fIarg\fR that accompanied the  \fBspeed=\fR option could not be
 162 interpreted as a decimal integer.
 163 .RE
 164
 165 .sp
 166 .ne 2
 167 .na
 168 \fB\fBBad arg: \fR\fIarg\fR\fR
 169 .ad
 170 .sp .6
 171 .RS 4n
 172 The string  \fIarg\fR did not make sense as an option.
 173 .RE
 174
 175 .sp
 176 .ne 2
 177 .na
 178 \fB\fBioctl failure code = \fR\fIerrno\fR\fR
 179 .ad
 180 .sp .6
 181 .RS 4n
 182 An \fBioctl\fR(2) system called failed. The meaning of the value of
 183 \fIerrno\fR may be found in \fBIntro\fR(2).
 184 .RE
 185
 186 .SH WARNINGS
 187 .LP
 188 Do not use \fBsyncinit\fR on an active serial link, unless needed to resolve
 189 an error condition. Do not use this command casually or without being aware of
 190 the consequences.