vinagre(1) [suse man page]

VINAGRE(1)						      General Commands Manual							VINAGRE(1)

NAME

       vinagre - a remote desktop viewer for the GNOME Desktop

SYNOPSYS

       vinagre [OPTIONS] [server][::port|:display]

DESCRIPTION

       vinagre	is  a  remote desktop viewer for the GNOME desktop. It can support many protocols using a plugin system. Current plugins exist for
       VNC and SSH.  Vinagre has many features, among others:.

       - Support for multiple connections simultaneously

       - Bookmarks and history support

       - Avahi integration

       - GNOME keyring integration

       - GNOME panel applet to quickly launch vinagre to access VNC servers

       - You can connect to a VNC server by double clicking on a .vnc file when using nautilus.

OPTIONS

   Help Options:
       -?, --help
	      Show help options

       --help-all
	      Show all help options

       --help-gtk
	      Show GTK+ options

   Application Options:
       --help-vnc
	      Show VNC options

       -F, --file=filename
	      Opens a .vnc file

       -f, --fullscreen
	      Open vinagre in fullscreen mode

       -n, --new-window
	      Create a new toplevel window in an existing instance of vinagre

       --display=DISPLAY
	      X display to use

       Run 'vinagre --help' to see a full list of available command line options

OPERANDS

       The following operands are supported:

       [server][::port|:display]
	      Specifies the VNC server to connect to. The VNC server can be either a hostname, or an IP address. If the server is an IPv6 address,
	      it must be enclosed by square brackets. The address can optionally be followed by two colons (::) and the VNC port number, or alter-
	      natively by one colon (:) and the display where Vinagre should run. If a port is not specified, default value of 5900 will be  used.
	      If  the value is lower than 1024, 5900 will be added to it. For example, ":0" means "5900" and ":1" means ":5901". If only a port is
	      specified, but not the hostname, localhost will be assumed.  Possible values for the display are between 0 and 1024.  If	a  display
	      number greater than 1024 is specified, it will be assumed to be a port.  Note that you can't specify the port and the display at the
	      same time.

EXAMPLES

       Example 1: Start vinagre from the command line

       example% vinagre

       Example 2: Create a new top-level window

       example% vinagre --new-window

       Example 3: Connect to a specified VNC server and port

       example% vinagre snoopy::5900

       Example 4: Connect to a specified IPv4 address and port

       example% vinagre 192.168.1.35::2700

       Example 5: Connect to a specified IPv6 address and port

       example% vinagre [2001:0db8:0:0:0:0:1428:57ab]::2700

       Example 6: Connect to a VNC server specified by a .vnc file

       example% vinagre -F snoopy.vnc

       Example 7: Connect to localhost on a specified port in fullscreen mode

       example% vinagre -f ::5900

SEE ALSO

       Vinagre help manual

AUTHOR

       Vinagre was written by Jonh Wendell <wendell@bani.com.br>

       This manual page was written by Emilio Pozuelo Monfort <pochu@ubuntu.com> and Halton Huo <halton.huo@sun.com>.

User Commands							 August 12th 2009							VINAGRE(1)

vncserver(1)						     Virtual Network Computing						      vncserver(1)

NAME

       vncserver - start or stop a VNC server

SYNOPSIS

       vncserver [:display#] [-name desktop-name] [-geometry widthxheight] [-depth depth] [-pixelformat format] [Xvnc-options...]
       vncserver -kill :display#

DESCRIPTION

       vncserver  is used to start a VNC (Virtual Network Computing) desktop.  vncserver is a Perl script which simplifies the process of starting
       an Xvnc server.	It runs Xvnc with appropriate options and starts some X applications to be displayed in the VNC desktop.

       vncserver can be run with no options at all. In this case it will choose the first available display number (usually  :1),  start  Xvnc	as
       that display, and run a couple of basic applications to get you started. You can also specify the display number, in which case it will use
       that number if it is available and exit if not, eg:

	      vncserver :13

       Editing the file $HOME/.vnc/xstartup allows you to change the applications run at startup (but note that this will not affect  an  existing
       desktop).

OPTIONS

       You  can  get  a list of options by giving -h as an option to vncserver.  In addition to the options listed below, any unrecognised options
       will be passed to Xvnc - see the Xvnc man page, or "Xvnc -help" for details.

       -name desktop-name
	      Each desktop has a name which may be displayed by the viewer. It defaults to "host:display# (username)" but you can change  it  with
	      this  option.   It is passed in to the xstartup script via the $VNCDESKTOP environment variable, allowing you to run a different set
	      of applications according to the name of the desktop.

       -geometry widthxheight
	      Specify the size of the desktop to be created. Default is 1024x768.  Can be specified as an array or scalar for geometry.

       -depth depth
	      Specify the pixel depth in bits of the desktop to be created. Default is 16, other possible values are 8, 15 and 24 - anything  else
	      is likely to cause strange behaviour by applications.

       -pixelformat format
	      Specify pixel format for server to use (BGRnnn or RGBnnn).  The default for depth 8 is BGR233 (meaning the most significant two bits
	      represent blue, the next three green, and the least significant three represent red), the default for depth 16  is  RGB565  and  for
	      depth 24 is RGB888.

       -cc 3  As  an  alternative to the default TrueColor visual, this allows you to run an Xvnc server with a PseudoColor visual (i.e. one which
	      uses a colour map or palette), which can be useful for running some old X applications which only work on such  a  display.   Values
	      other  than 3 (PseudoColor) and 4 (TrueColor) for the -cc option may result in strange behaviour, and PseudoColor desktops must be 8
	      bits deep.

       -kill :display#
	      This kills a VNC desktop previously started with vncserver.  It does this by killing the Xvnc process, whose process ID is stored in
	      the  file  "$HOME/.vnc/host:display#.pid".  It actually ignores anything preceding a ":" in its argument.  This can be useful so you
	      can write "vncserver -kill $DISPLAY", for example at the end of your xstartup file after a particular application exits.

FILES

       Several VNC-related files are found in the directory $HOME/.vnc:

       $HOME/.vnc/xstartup
	      A shell script specifying X applications to be run when a VNC desktop is started.  If it doesn't exist, vncserver will create a  new
	      one which runs a couple of basic applications.

       $HOME/.vnc/passwd
	      The VNC password file.

       $HOME/.vnc/host:display#.log
	      The log file for Xvnc and applications started in xstartup.

       $HOME/.vnc/host:display#.pid
	      Identifies the Xvnc process ID, used by the -kill option.

SEE ALSO

       vncviewer(1), vncpasswd(1), vncconfig(1), Xvnc(1)
       http://www.realvnc.com

AUTHOR

       Tristan Richardson, RealVNC Ltd.

       VNC  was originally developed by the RealVNC team while at Olivetti Research Ltd / AT&T Laboratories Cambridge.	It is now being maintained
       by RealVNC Ltd.	See http://www.realvnc.com for details.

RealVNC Ltd							    03 Mar 2005 						      vncserver(1)