Xremote(1)               USER COMMANDS                 Xremote(1)



NAME
     Xremote - X Protocol interpreter for serial lines

SYNOPSIS
     Xremote [:n] [-line /dev/ttyxxx] [-speed rate] [-scanbase n]
     [-scanmax n] [-report fd]

DESCRIPTION
     Typically, the Xremote program is  invoked  by  xinitremote.
     The  program  xinitremote  will  also initiate one or more X
     windows client programs.

     The Xremote program is a protocol interpreter which acts  as
     the  endpoint of a TCP-domain X Windows connection, and com-
     municates over a serial line to an appropriately  configured
     NCD X server.  It listens on TCP port 6000+n on the host for
     incoming connections from X-windows clients on the  network,
     and  multiplexes  all  these  clients'  X-wire data over the
     serial line to the NCD.  The Xremote program starts  looking
     for  available  TCP ports at its default base of 6001, which
     corresponds to X display 1, and attempts to bind to  succes-
     sive ports up to 6051.

     A full duplex 3-layer protocol stack is used by  Xremote  to
     connect the helper process on the host machine to the server
     code running in the NCD.

     The lowest layer of the Xremote protocol is a datagram  ser-
     vice. Each datagram is protected by a 16-bit CRC frame check
     sequence.  A character-stuffing mechanism is  used  to  mark
     datagram  boundaries,  and to escape certain special charac-
     ters in the data stream.

     A second level is used to implement a  reliable  full-duplex
     data  stream,  which allows multiple in-flight packets, han-
     dles packet retransmission, and utilizes a  general  purpose
     data compression mechanism.

     The highest level provides additional X-wire  specific  data
     compression,  as  well as X-connection and X-wire data tran-
     sport services.

OPTIONS
     -line /dev/ttyxxx
             Use the specified device name for running the serial
             protocol. The default is /dev/tty.

     -speed rate
             Set the baud rate on the line to the given rate. The
             default is to use whatever rate is currently set.

     -scanbase n



                                                                1

Xremote(1)               USER COMMANDS                 Xremote(1)



             Set the base for the display scanning.  The  default
             is  1.  This number is added to 6000 to generate the
             TCP port number upon which the Xremote process  will
             listen for incoming X connections.

     :n      Same as -scanbase n.  Used  for  compatibility  with
             other xinitremote-style startup sequences.

     -scanmax n
             Limits the number of TCP ports which will be scanned
             before  giving  up.  The default is 1 if the -report
             option is not specified, and 50 if -report is speci-
             fied.

     -report fd
             Emit the the display number which  was  obtained  by
             the TCP port scan on inherited file descriptor fd as
             a decimal number.  Typically, this  file  descriptor
             is  the writable side of a pipe into the parent pro-
             cess. This argument is supplied  automatically  when
             xinitremote invokes Xremote.  The file descriptor is
             closed immediately after the display number is writ-
             ten.

SIGNALS
     When the Xremote process is ready to accept connections,  it
     will send a SIGUSR1 signal to its parent process.

FILES
     /dev/tty            The default line on  which  to  run  the
                         Xremote server

SEE ALSO
     X(1), xinitremote(1).





















                                                                2