IABSD.fr/xenocara/app/scripts/xon.man

Branch : - branch - master - tag -

• Show log

  Commit

• Author : matthieu
  Date : 2006-11-25 20:07:29
  Hash : 616b6f15
  Message : Importing from X.Org 7.2RC2

• app/scripts/xon.man

• .\" $Xorg: xon.man,v 1.4 2001/02/09 02:05:35 xorgcvs Exp $
  .\" Copyright 1994, 1998  The Open Group
  .\" 
  .\" Permission to use, copy, modify, distribute, and sell this software and its
  .\" documentation for any purpose is hereby granted without fee, provided that
  .\" the above copyright notice appear in all copies and that both that
  .\" copyright notice and this permission notice appear in supporting
  .\" documentation.
  .\" 
  .\" The above copyright notice and this permission notice shall be included in
  .\" all copies or substantial portions of the Software.
  .\" 
  .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  .\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  .\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL 
  .\" THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
  .\" WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF 
  .\" OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 
  .\" SOFTWARE.
  .\" 
  .\" Except as contained in this notice, the name of The Open Group shall not 
  .\" be used in advertising or otherwise to promote the sale, use or other 
  .\" dealing in this Software without prior written authorization from the 
  .\" The Open Group.
  .\"
  .\" $XFree86: xc/programs/scripts/xon.man,v 1.6 2001/01/27 18:21:05 dawes Exp $
  .\"
  .TH XON 1 __xorgversion__
  .SH NAME
  xon \- start an X program on a remote machine
  .SH SYNOPSIS
  .B xon
  remote-host [-access] [-debug] [-name window-name] [-nols] [-screen screen-no]
  [-user user-name] [command ...]
  .SH DESCRIPTION
  .I Xon
  runs the specified command (default xterm -ls) on the remote machine using
  rsh, remsh, or rcmd.  Xon passes the DISPLAY, XAUTHORITY and
  XUSERFILESEARCHPATH environment variables to the remote command.
  .PP
  When no command is specified, xon runs 'xterm -ls'.  It additionally
  specifies the application name to be 'xterm-\fIremote-host\fP' and the
  window title to be '-fIremote-host\fP'.
  .PP
  Xon can only work when the remote host will allow you to log in without a
  password, by having an entry in the .rhosts file permitting access.
  .SH OPTIONS
  .PP
  Note that the options follow the remote host name (as they do with rlogin).
  .sp
  .IP "\fB-access\fP"
  Runs xhost locally to add the remote host to the host access list in the X
  server.  This won't work unless xhost is given permission to modify the
  access list.
  .IP "\fB-debug\fP"
  Normally, xon disconnects the remote process from stdin, stdout and stderr
  to eliminate the daemon processes which usually connect them across the
  network.  Specifying the \fB-debug\fP option leaves them connected so that
  error messages from the remote execution are sent back to the originating
  host.
  .IP "\fB-name window-name\fP"
  This specifies a different application name and window title for the default
  command (xterm).
  .IP "\fB-nols\fP"
  Normally xon passes the -ls option to the remote xterm; this option
  suspends that behaviour.
  .IP "\fB-screen screen-no\fP"
  This changes the screen number of the DISPLAY variable passed to the remote
  command.
  .IP "\fB-user user-name\fP"
  By default, xon simply uses rsh/remsh/rcmd to connect to the remote machine
  using the
  same user name as on the local machine.  This option cause xon to specify an
  alternative user name.  This will not work unless you have authorization to
  access the remote account, by placing an appropriate entry in the
  remote users .rhosts file.
  .SH BUGS
  Xon can get easily confused when the remote-host, user-name or various
  environment variable values contain white space.
  .PP
  Xon has no way to send the appropriate X authorization information to the
  remote host.