<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!ENTITY cmd "vinagre">

<!ENTITY % commonents SYSTEM "smancommon.ent">

%commonents;

<!ENTITY % booktitles SYSTEM "booktitles.ent">

%booktitles;

<!ENTITY suncopy "Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.">

]>

<?Pub UDT _bookmark _target>

<?Pub Inc>

<refentry id="vinagre-1">

<refmeta><refentrytitle>&cmd;</refentrytitle><manvolnum>1</manvolnum>

<refmiscinfo class="date">14 Nov 2008</refmiscinfo>

<refmiscinfo class="sectdesc">&man1;</refmiscinfo>

<refmiscinfo class="software">&release;</refmiscinfo>

<refmiscinfo class="arch">generic</refmiscinfo>

<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

</refmeta>

<indexterm><primary>&cmd;</primary></indexterm><indexterm><primary>VNC client for the GNOME Desktop</primary></indexterm>

<refnamediv id="vinagre-1-name">

<refname>&cmd;</refname>

<refpurpose>VNC client for the GNOME Desktop</refpurpose></refnamediv>

<refsynopsisdiv id="vinagre-1-synp"><title>&synp-tt;</title>

<cmdsynopsis><command>&cmd;</command>

<arg choice="opt"><option>-gtk-vnc-debug</option></arg>

<arg choice="opt"><option>-file=<replaceable>filename</replaceable></option></arg>

<arg choice="opt"><option>-new-window</option></arg>

<arg choice="opt"><option role="nodash"><replaceable>gnome-std-options</replaceable></option></arg>

<arg choice="opt"><option role="nodash"><replaceable>server</replaceable>[:<replaceable>port</replaceable>]</option></arg>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1 id="vinagre-1-desc"><title>&desc-tt;</title>

<para>

<command>&cmd;</command> is a VNC client for the GNOME desktop which is popular due to its features.

</para>

<para>- You can connect to several machines at the same time</para>

<para>- You can save your most used connections as bookmarks</para>

<para>- You can access your recently used connections</para>

<para>- You can browse your network for VNC servers</para>

<para>- You do not need to supply a password for every connection because vinagre is integrated with gnome-keyring and it securely manages connection passwords for you</para>

<para>- You can add a GNOME panel applet to quickly launch vinagre to access VNC servers</para>

<para>- You can connect to a VNC server by double clicking on a .vnc file when using nautilus. This file is in a format recognized by vinagre to specify a VNC server, eg:</para>

<screen>

[connection]

host=snoopy

port=5900

</screen>

<para>where 'snoopy' is the name of the machine, and '5900' is the port number.</para>

</refsect1>

<refsect1 id="vinagre-1-opts"><title>&opts-tt;</title>

<para>The following options are supported:</para>

<variablelist termlength="medium">

<varlistentry>

<term><option>-gtk-vnc-debug</option></term>

<listitem><para>Enables debug output</para></listitem>

</varlistentry>

<varlistentry>

<term><option>f, --file=<replaceable>filename</replaceable></option></term>

<listitem><para>Opens a .vnc file</para></listitem>

</varlistentry>

<varlistentry>

<term><option>n, --new-window</option></term>

<listitem><para>Create a new toplevel window in an existing instance of vinagre</para></listitem>

</varlistentry>

<varlistentry>

<term><option role="nodash"><replaceable>gnome-std-options</replaceable></option></term>

<listitem><para>Standard options available for use with most GNOME applications. See <citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more information.</para></listitem>

</varlistentry>

</variablelist></refsect1>

<refsect1 id="vinagre-1-oper"><title>&oper-tt;</title>

<para>The following operands are supported:</para>

<variablelist termlength="medium">

<varlistentry><term><option role="nodash"><replaceable>server</replaceable>[:<replaceable>port</replaceable>]</option></term>

<listitem><para>Specifies the VNC server to connect with. The VNC server name or IP address is followed by a colon (:) character, and then followed by the VNC port number. The port specification is optional. If it is not specified, default value of 5900 will be used. If the value is lower than 1024, it will add 5900. For example, ":0" means "5900" and ":1" means ":5901".</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="vinagre-1-exam"><title>&exam-tt;</title>

<example role="example">

<title>Start &cmd; from the command line</title>

<para><screen>example% <userinput>&cmd;</userinput></screen></para>

</example>

<example role="example">

<title>Create a new top-level window</title>

<para><screen>example% <userinput>&cmd; --new-window</userinput></screen></para>

</example>

<example role="example">

<title>Connect to a specified VNC server and port</title>

<para><screen>example% <userinput>&cmd; snoopy:5900</userinput></screen></para>

</example>

<example role="example">

<title>Connect to a VNC server specified by a .vnc file</title>

<para><screen>example% <userinput>&cmd; -f snoopy.vnc</userinput></screen></para>

</example>

</refsect1>

<refsect1 id="vinagre-1-attr"><title>&attr-tt;</title>

<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>

<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>

for descriptions of the following attributes:</para>

<informaltable frame="all">

<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">

<colspec colname="COLSPEC1" colwidth="1*">

<thead>

<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"

valign="middle">ATTRIBUTE VALUE</entry></row>

</thead>

<tbody>

<row><entry><para>Availability</para></entry><entry><para>desktop/remote-desktop/vinagre</para></entry>

</row>

<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry

colname="COLSPEC1"><para>Volatile</para></entry></row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 id="vinagre-1-also"><title>&also-tt;</title>

<para>

<citerefentry><refentrytitle>vncviewer</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>libgnome-keyring</refentrytitle><manvolnum>3</manvolnum></citerefentry>,

<citerefentry><refentrytitle>libgtk-vnc-1.0</refentrytitle><manvolnum>3</manvolnum></citerefentry>,

<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,

<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>

</para>

<para>Online Help for <command>&cmd;</command>.</para>

</refsect1>

<refsect1 id="vinagre-1-note"><title>&note-tt;</title>

<para>Vinagre was written by Jonh Wendell <<literal>wendell@bani.com.br</literal>>. This manual page was written by Emilio Pozuelo Monfort <<literal>pochu@ubuntu.com</literal>>.</para>

<para>Updated by Halton Huo, Sun Microsystems Inc., 2008.</para>

</refsect1>

</refentry>