source: xsoft/other/tigervnc.xml@ 7533b650

10.0 10.1 11.0 11.1 7.10 7.6 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind krejzi/svn lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 7533b650 was 7533b650, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@14364 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 10.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY tigervnc-download-http " ">
8 <!ENTITY tigervnc-download-ftp "&sourceforge-repo;/project/tigervnc/tigervnc/&tigervnc-version;/tigervnc-&tigervnc-version;.tar.gz">
9 <!ENTITY tigervnc-md5sum "e80b16aa74f1d8e89f284a6aef99955d">
10 <!ENTITY tigervnc-size "6.6 MB">
11 <!ENTITY tigervnc-buildsize "168 MB">
12 <!ENTITY tigervnc-time "1.7 SBU">
13]>
14
15<sect1 id="tigervnc" xreflabel="tigervnc-&tigervnc-version;">
16 <?dbhtml filename="tigervnc.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy: bdubbs $</othername>
20 <date>$Date: 2014-03-01 00:00:12 -0600 (Sat, 01 Mar 2014) $</date>
21 </sect1info>
22
23 <title>Tigervnc-&tigervnc-version;</title>
24
25 <indexterm zone="tigervnc">
26 <primary sortas="a-tigervnc">tigervnc</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Tigervnc</title>
31
32 <para><application>Tigervnc</application> is an advanced VNC (Virtual
33 Network Computing) implementation. It allows creation of an Xorg server
34 not tied to a physical console and also provides a client for
35 viewing of the remote graphical desktop.
36 </para>
37
38 &lfs76_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>Download (HTTP): <ulink url="&tigervnc-download-http;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download (FTP): <ulink url="&tigervnc-download-ftp;"/></para>
47 </listitem>
48 <listitem>
49 <para>Download MD5 sum: &tigervnc-md5sum;</para>
50 </listitem>
51 <listitem>
52 <para>Download size: &tigervnc-size;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated disk space required: &tigervnc-buildsize;</para>
56 </listitem>
57 <listitem>
58 <para>Estimated build time: &tigervnc-time;</para>
59 </listitem>
60 </itemizedlist>
61
62 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
63 <itemizedlist spacing="compact">
64 <listitem>
65 <para>
66 Required file:
67 <ulink url="&xorg-download-ftp;/xserver/xorg-server-1.15.0.tar.bz2"/>
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Required patch:
73 <ulink url="&patch-root;/tigervnc-&tigervnc-version;-gethomedir-1.patch"/>
74 </para>
75 </listitem>
76 <listitem>
77 <para>
78 Required patch:
79 <ulink url="&patch-root;/tigervnc-&tigervnc-version;-getmaster-1.patch"/>
80 </para>
81 </listitem>
82 <listitem>
83 <para>
84 Required patch:
85 <ulink url="&patch-root;/tigervnc-&tigervnc-version;-xorg115-1.patch"/>
86 </para>
87 </listitem>
88 </itemizedlist>
89
90 <note><para>The version of <application>Xorg</application> is a few versions
91 out of date, but is required for the customizations needed for this
92 package.</para></note>
93
94 <bridgehead renderas="sect3">Tigervnc Dependencies</bridgehead>
95
96 <bridgehead renderas="sect4">Required</bridgehead>
97 <para role="required">
98 <xref linkend="cmake"/>,
99 <xref linkend="fltk"/>,
100 <xref linkend="gnutls"/>,
101 <xref linkend="libgcrypt"/>,
102 <xref linkend="libjpeg"/>,
103 <xref linkend="nasm"/>,
104 <xref linkend="pixman"/>, and
105 <xref linkend="xorg7-app"/>
106 </para>
107
108 <bridgehead renderas="sect4">Recommended</bridgehead>
109 <para role="recommended">
110 <xref linkend="imagemagick"/> and
111 <xref linkend="linux-pam"/>
112 </para>
113
114 <para condition="html" role="usernotes">User Notes:
115 <ulink url="&blfs-wiki;/tigervnc"/></para>
116
117 </sect2>
118
119 <sect2 role="installation">
120 <title>Installation of Tigervnc</title>
121
122 <para>Install <application>tigervnc</application> by running the following
123 commands:</para>
124
125<screen><userinput>tar -xf ../xorg-server-1.15.0.tar.bz2 -C unix/xserver --strip-components=1 &amp;&amp;
126
127patch -Np1 -i ../tigervnc-&tigervnc-version;-gethomedir-1.patch &amp;&amp;
128patch -Np1 -i ../tigervnc-&tigervnc-version;-getmaster-1.patch &amp;&amp;
129patch -Np1 -i ../tigervnc-&tigervnc-version;-xorg115-1.patch &amp;&amp;
130
131cmake -G "Unix Makefiles" -DCMAKE_INSTALL_PREFIX=/usr &amp;&amp;
132make &amp;&amp;
133
134pushd unix/xserver &amp;&amp;
135 patch -Np1 -i ../xserver114.patch &amp;&amp;
136 autoreconf -fiv &amp;&amp;
137
138 ./configure $XORG_CONFIG \
139 --disable-present --disable-dri3 --disable-dmx \
140 --disable-static --disable-xinerama --disable-dri \
141 --disable-xorg --disable-xnest --disable-xvfb \
142 --disable-xwin --disable-xephyr --disable-kdrive \
143 --disable-config-dbus --disable-config-hal --disable-config-udev \
144 --disable-unit-tests --disable-selective-werror \
145 --without-dtrace --enable-dri2 --enable-glx \
146 --enable-glx-tls --with-pic &amp;&amp;
147 make &amp;&amp;
148popd</userinput></screen>
149
150 <para>This package does not come with a test suite.</para>
151
152 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
153
154<screen role="root"><userinput>make install &amp;&amp;
155
156cd unix/xserver/hw/vnc &amp;&amp;
157make install &amp;&amp;
158sed -i 's/iconic/nowin/' /usr/bin/vncserver &amp;&amp;
159[ -e /usr/bin/Xvnc ] || ln -svf $XORG_PREFIX/bin/Xvnc /usr/bin/Xvnc</userinput></screen>
160
161 <para>Finally, create a menu entry. As the
162 <systemitem class="username">root</systemitem> user:</para>
163
164<screen role="root"><userinput>cat &gt; /usr/share/applications/vncviewer.desktop &lt;&lt; "EOF"
165<literal>[Desktop Entry]
166Type=Application
167Name=TigerVNC Viewer
168Comment=VNC client
169Exec=/usr/bin/vncviewer
170Icon=tigervnc
171Terminal=false
172StartupNotify=false
173Categories=Network;RemoteAccess;</literal>
174EOF</userinput></screen>
175
176 </sect2>
177
178 <sect2 role="commands">
179 <title>Command Explanations</title>
180
181 <para><command>tar .. xorg-server...</command>: This command extracts the
182 standard Xorg packages into the tree in a location needed for modification.</para>
183
184 <para><command>patch ...</command>: This set of patches modifies the standard
185 Xorg server so that the Xvnc command can be built.</para>
186
187 <para><option>--disable ...</option>: Most options that are usually needed for
188 the standard Xorg server are not needed fror the Xvnc instance being built.</para>
189
190 <para><command>[ -e /usr/bin/Xvnc ] || ln ... Xvnc</command>: If the Xvnc server
191 is not installed in the <filename class='directory'>/usr/bin</filename>
192 directory, then create a link so the <command>vncserver</command> script
193 can find it.</para>
194
195 </sect2>
196
197 <sect2 role="configuration">
198 <title>Configuring Tigervnc</title>
199
200 <para>The user specific configuration files of vncserver resides
201 in the <filename class='directory'>.vnc</filename> directory in the user's
202 home directory. The <filename>xstartup</filename> file in that
203 directory is a script specifying what commands to be run
204 when a VNC desktop is started. If no <filename>xstartup</filename> file
205 exists, <command>vncserver</command> will try to start an xterm in a twm
206 session. An example <filename>xstartup</filename> would be:</para>
207
208<screen>#!/bin/sh
209
210[ -x /etc/vnc/xstartup ] &amp;&amp; exec /etc/vnc/xstartup
211[ -r $HOME/.Xresources ] &amp;&amp; xrdb $HOME/.Xresources
212startlxde &amp;</screen>
213
214 </sect2>
215
216 <sect2 role="content">
217 <title>Contents</title>
218
219 <segmentedlist>
220 <segtitle>Installed Programs</segtitle>
221 <segtitle>Installed Libraries</segtitle>
222 <segtitle>Installed Directories</segtitle>
223
224 <seglistitem>
225 <seg>Xvnc,
226 vncconfig,
227 vncpasswd,
228 vncserver,
229 vncviewer, and
230 x0vncserver</seg>
231
232 <seg>libvnc.so</seg>
233 <seg>None</seg>
234 </seglistitem>
235 </segmentedlist>
236
237 <variablelist>
238 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
239 <?dbfo list-presentation="list"?>
240 <?dbhtml list-presentation="table"?>
241
242 <varlistentry id="xvnc">
243 <term><command>Xvnc</command></term>
244 <listitem>
245 <para> is a X VNC (Virtual Network Computing) server.
246 It is based on a standard X server, but it has a
247 "virtual" screen rather than a physical one.</para>
248 <indexterm zone="tigervnc xvnc">
249 <primary sortas="b-xvnc">Xvnc</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="vncconfig">
255 <term><command>vncconfig</command></term>
256 <listitem>
257 <para>is a program to configure and control a VNC server.</para>
258 <indexterm zone="tigervnc vncconfig">
259 <primary sortas="b-vncconfig">vncconfig</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 <varlistentry id="vncserver">
265 <term><command>vncserver</command></term>
266 <listitem>
267 <para>is a perl script used to start or stop a VNC server.</para>
268 <indexterm zone="tigervnc vncserver">
269 <primary sortas="b-vncserver">vncserver</primary>
270 </indexterm>
271 </listitem>
272 </varlistentry>
273
274 <varlistentry id="vncviewer">
275 <term><command>vncviewer</command></term>
276 <listitem>
277 <para>is a client used to access VNC desktops.</para>
278 <indexterm zone="tigervnc vncviewer">
279 <primary sortas="b-vncviewer">vncviewer</primary>
280 </indexterm>
281 </listitem>
282 </varlistentry>
283
284 <varlistentry id="x0vncserver">
285 <term><command>x0vncserver</command></term>
286 <listitem>
287 <para>is a program to make an X display onm a physical
288 terminal accessible via TigerVNC or compatible viewers.</para>
289 <indexterm zone="tigervnc x0vncserver">
290 <primary sortas="b-x0vncserver">x0vncserver</primary>
291 </indexterm>
292 </listitem>
293 </varlistentry>
294
295 </variablelist>
296
297 </sect2>
298
299</sect1>
Note: See TracBrowser for help on using the repository browser.