syncinit(1M)						  System Administration Commands					      syncinit(1M)

NAME

       syncinit - set serial line interface operating parameters

SYNOPSIS

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

DESCRIPTION

       The  syncinit utility allows the user to modify some of the hardware operating modes common to synchronous serial lines. This can be useful
       in troubleshooting a link, or necessary to the operation of a communications package.

       If run without options, syncinit reports the options as presently set on the port. If options are specified, the new settings are  reported
       after they have been made.

OPTIONS

       Options	to  syncinit  normally take the form of a keyword, followed by an equal sign and a value. The exception is that a baud rate may be
       specified as a decimal integer by itself. Keywords must begin with the value shown in the options table, but may contain additional letters
       up to the equal sign. For example,  loop= and loopback= are equivalent.

       The following options are supported:

       Keyword	   Value      Effect
       loop	   yes	      Set  the	port  to operate in internal
			      loopback mode. The receiver  is  elec-
			      trically	disconnected  from  the  DCE
			      receive data input  and  tied  to  the
			      outgoing	transmit data line. Transmit
			      data is available to the DCE. The Dig-
			      ital  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 txc=baud and rxc=baud.
		   no	      Disable internal loopback mode.  If no
			      other clocking options have been spec-
			      ified,   perform	 the  equivalent  of
			      txc=txc and rxc=rxc.
       echo	   yes	      Set the port to operate  in  auto-echo
			      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  auto-echo
			      mode is useful to make a system become
			      the  endpoint  of  a  remote  loopback
			      test.
		   no	      Disable auto-echo mode.
       nrzi	   yes	      Set the port to operate with NRZI data
			      encoding.
		   no	      Set the port to operate with NRZ	data
			      encoding.

       txc	   txc	      Transmit	clock source will be the TxC
			      signal (pin 15).
		   rxc	      Transmit clock source will be the  RxC
			      signal (pin 17).
		   baud       Transmit	clock  source  will  be  the
			      internal baud rate generator.
		   pll	      Transmit clock source will be the out-
			      put of the DPLL circuit.
       rxc	   rxc	      Receive  clock  source will be the RxC
			      signal (pin 17).
		   txc	      Receive clock source will be  the  TxC
			      signal (pin 15).
		   baud       Receive	clock  source  will  be  the
			      internal baud rate generator.
		   pll	      Receive clock source will be the	out-
			      put of the DPLL circuit.
       speed	   integer    Set  the baud rate to integer bits per
			      second.

       There are also several single-word options that set one or more paramaters at a time:

       Keyword			     Equivalent to Options:
       external 		     txc=txc rxc=rxc loop=no
       sender			     txc=baud rxc=rxc loop=no
       internal 		     txc=pll rxc=pll loop=no
       stop			     speed=0

EXAMPLES

       Example 1 Using syncinit

       The following command sets the first CPU port to loop internally, using internal clocking and operating at 38400 baud:

	 example# syncinit zsh0 38400 loop=yes
	 device: /dev/zsh  ppa: 0
	 speed=38400, loopback=yes, echo=no, nrzi=no, txc=baud, rxc=baud

       The following command sets the same port's clocking, local loopback and baud rate settings to their default values:

	 example# syncinit zsh0 stop loop=no
	 device: /dev/zsh  ppa: 0
	 speed=0, loopback=no, echo=no, nrzi=no, txc=txc, rxc=rxc

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

DIAGNOSTICS

       device missing minor device number

	   The name  device does not end in a decimal number that can be used as a minor device number.

       bad speed: arg

	   The string  arg that accompanied the  speed= option could not be interpreted as a decimal integer.

       Bad arg: arg

	   The string  arg did not make sense as an option.

       ioctl failure code = errno

	   An ioctl(2) system called failed. The meaning of the value of  errno may be found in intro(2).

WARNINGS

       Do not use syncinit on an active serial link, unless needed to resolve  an error condition. Do not use this  command  casually  or  without
       being aware of the consequences.

SunOS 5.11							    9 Mar 1993							      syncinit(1M)