source: xsoft/other/tigervnc.xml

trunk
Last change on this file was b4609782, checked in by Douglas R. Reno <renodr@…>, 2 weeks ago

TigerVNC: comment out unnecessary note

This might become necessary again if a new major version of Xorg Server
breaks this package's build process.

  • Property mode set to 100644
File size: 17.3 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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 "https://github.com/TigerVNC/tigervnc/archive/v&tigervnc-version;/tigervnc-&tigervnc-version;.tar.gz">
8 <!ENTITY tigervnc-download-ftp " ">
9 <!ENTITY tigervnc-md5sum "3a794e3a063443e07250de8e99e2e05a">
10 <!ENTITY tigervnc-size "1.8 MB">
11 <!ENTITY tigervnc-buildsize "97 MB">
12 <!ENTITY tigervnc-time "0.4 SBU (Using parallelism=4)">
13 <!--<!ENTITY tigervnc-xorg-version "21.1.12">-->
14]>
15
16<sect1 id="tigervnc" xreflabel="tigervnc-&tigervnc-version;">
17 <?dbhtml filename="tigervnc.html"?>
18
19
20 <title>Tigervnc-&tigervnc-version;</title>
21
22 <indexterm zone="tigervnc">
23 <primary sortas="a-tigervnc">tigervnc</primary>
24 </indexterm>
25
26 <sect2 role="package">
27 <title>Introduction to Tigervnc</title>
28
29 <para>
30 <application>Tigervnc</application> is an advanced VNC (Virtual
31 Network Computing) implementation. It allows creation of an Xorg server
32 not tied to a physical console and also provides a client for
33 viewing of the remote graphical desktop.
34 </para>
35
36 &lfs121_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&tigervnc-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&tigervnc-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &tigervnc-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &tigervnc-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &tigervnc-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &tigervnc-time;
68 </para>
69 </listitem>
70 </itemizedlist>
71
72 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
73 <itemizedlist spacing="compact">
74 <listitem>
75 <para>
76 Required file:
77 <ulink url="&xorg-download-http;/xserver/xorg-server-&xorg-server-version;.tar.xz"/>
78 </para>
79 </listitem>
80 </itemizedlist>
81
82<!-- Commented out since we're tracking the same xorg-server right now
83 <note>
84 <para>
85 The version of <application>Xorg</application> may eventually be a few
86 versions out of date, but is required for the customizations needed
87 for this package.
88 </para>
89 </note>
90-->
91
92 <itemizedlist spacing="compact">
93 <listitem>
94 <para>
95 Required patch:
96 <ulink url="&patch-root;/tigervnc-&tigervnc-version;-configuration_fixes-1.patch"/>
97 </para>
98 </listitem>
99 <listitem revision='sysv'>
100 <para>
101 Optional file to start the server without a display manager:
102 <ulink url="&sources-anduin-http;/tigervnc/vncserver"/>
103 </para>
104 </listitem>
105 <listitem revision='sysv'>
106 <para>
107 Optional manual page:
108 <ulink url="&sources-anduin-http;/tigervnc/vncserver.1"/>
109 </para>
110 </listitem>
111 <listitem revision='systemd'>
112 <para>
113 Optional file to start the server without a display manager:
114 <ulink url="&sources-anduin-http;/tigervnc/Xsession"/>
115 </para>
116 </listitem>
117 </itemizedlist>
118
119 <bridgehead renderas="sect3">Tigervnc Dependencies</bridgehead>
120
121 <bridgehead renderas="sect4">Required</bridgehead>
122 <para role="required">
123 <xref linkend="cmake"/>,
124 <xref linkend="fltk"/>,
125 <xref linkend="gnutls"/>,
126 <xref linkend="libgcrypt"/>,
127 <xref linkend="libjpeg"/>,
128 <phrase revision='sysv'><xref linkend="linux-pam"/>,</phrase>
129 <xref linkend="pixman"/>,
130 <phrase revision='systemd'><xref linkend="systemd"/>
131 (with <xref linkend="linux-pam"/>),</phrase>
132 <xref linkend="xorg7-app"/>,
133 <xref linkend="xinit"/>, and
134 <xref linkend="xorg7-legacy"/>
135 </para>
136
137 <bridgehead renderas="sect4">Recommended</bridgehead>
138 <para role="recommended">
139 <xref linkend="imagemagick"/>
140 </para>
141
142
143 </sect2>
144
145 <sect2 role="installation">
146 <title>Installation of Tigervnc</title>
147
148 <para>
149 First, make adjustments to the configuration files to make them
150 compatible with LFS systems:
151 <!-- Replaces an incompatible PAM file and disables SELinux support
152 in systemd units. Also modifies the search path for
153 /usr/libexec/vncserver to include /etc/X11/tigervnc -->
154 </para>
155
156<screen><userinput remap="pre">patch -Np1 -i ../tigervnc-&tigervnc-version;-configuration_fixes-1.patch</userinput></screen>
157
158 <para>
159 Install <application>tigervnc</application> by running the following
160 commands:
161 </para>
162
163<screen revision="sysv"><userinput># Put code in place
164mkdir -p unix/xserver &amp;&amp;
165tar -xf ../xorg-server-&xorg-server-version;.tar.xz \
166 --strip-components=1 \
167 -C unix/xserver &amp;&amp;
168( cd unix/xserver &amp;&amp;
169 patch -Np1 -i ../xserver21.1.1.patch ) &amp;&amp;
170
171# Build viewer
172cmake -G "Unix Makefiles" \
173 -DCMAKE_INSTALL_PREFIX=/usr \
174 -DCMAKE_BUILD_TYPE=Release \
175 -DINSTALL_SYSTEMD_UNITS=OFF \
176 -Wno-dev . &amp;&amp;
177make &amp;&amp;
178
179# Build server
180pushd unix/xserver &amp;&amp;
181 autoreconf -fiv &amp;&amp;
182
183 CPPFLAGS="-I/usr/include/drm" \
184 ./configure $XORG_CONFIG \
185 --disable-xwayland --disable-dri --disable-dmx \
186 --disable-xorg --disable-xnest --disable-xvfb \
187 --disable-xwin --disable-xephyr --disable-kdrive \
188 --disable-devel-docs --disable-config-hal --disable-config-udev \
189 --disable-unit-tests --disable-selective-werror \
190 --disable-static --enable-dri3 \
191 --without-dtrace --enable-dri2 --enable-glx \
192 --with-pic &amp;&amp;
193 make &amp;&amp;
194popd</userinput></screen>
195
196<screen revision="systemd"><userinput># Put code in place
197mkdir -p unix/xserver &amp;&amp;
198tar -xf ../xorg-server-&xorg-server-version;.tar.xz \
199 --strip-components=1 \
200 -C unix/xserver &amp;&amp;
201( cd unix/xserver &amp;&amp;
202 patch -Np1 -i ../xserver21.1.1.patch ) &amp;&amp;
203
204# Build viewer
205cmake -G "Unix Makefiles" \
206 -DCMAKE_INSTALL_PREFIX=/usr \
207 -DCMAKE_BUILD_TYPE=Release \
208 -Wno-dev . &amp;&amp;
209make &amp;&amp;
210
211# Build server
212pushd unix/xserver &amp;&amp;
213 autoreconf -fiv &amp;&amp;
214
215 CPPFLAGS="-I/usr/include/drm" \
216 ./configure $XORG_CONFIG \
217 --disable-xwayland --disable-dri --disable-dmx \
218 --disable-xorg --disable-xnest --disable-xvfb \
219 --disable-xwin --disable-xephyr --disable-kdrive \
220 --disable-devel-docs --disable-config-hal --disable-config-udev \
221 --disable-unit-tests --disable-selective-werror \
222 --disable-static --enable-dri3 \
223 --without-dtrace --enable-dri2 --enable-glx \
224 --with-pic &amp;&amp;
225 make &amp;&amp;
226popd</userinput></screen>
227
228 <para>
229 This package does not come with a test suite.
230 </para>
231
232 <para>
233 Now, as the <systemitem class="username">root</systemitem> user:
234 </para>
235
236<screen role="root"><userinput>#Install viewer
237make install &amp;&amp;
238
239#Install server
240( cd unix/xserver/hw/vnc &amp;&amp; make install ) &amp;&amp;
241
242[ -e /usr/bin/Xvnc ] || ln -svf $XORG_PREFIX/bin/Xvnc /usr/bin/Xvnc</userinput></screen>
243
244 <para revision="sysv">
245 Finally, modify the PAM file to be compatible with elogind:
246 </para>
247
248<screen role="root" revision="sysv"><userinput>sed -i 's/pam_systemd.so/pam_elogind.so/' /etc/pam.d/tigervnc</userinput></screen>
249
250<!-- These are installed as part of 'make install' for the client.
251 <para>
252 Finally, create a menu entry. As the
253 <systemitem class="username">root</systemitem> user:
254 </para>
255
256<screen role="root"><userinput>cat &gt; /usr/share/applications/vncviewer.desktop &lt;&lt; "EOF"
257<literal>[Desktop Entry]
258Type=Application
259Name=TigerVNC Viewer
260Comment=VNC client
261Exec=/usr/bin/vncviewer
262Icon=tigervnc
263Terminal=false
264StartupNotify=false
265Categories=Network;RemoteAccess;</literal>
266EOF
267
268install -vm644 media/icons/tigervnc_24.png /usr/share/pixmaps &amp;&amp;
269ln -sfv tigervnc_24.png /usr/share/pixmaps/tigervnc.png</userinput></screen>
270-->
271 </sect2>
272
273 <sect2 role="commands">
274 <title>Command Explanations</title>
275
276 <para>
277 <command>tar -xf .. xorg-server...</command>: This command extracts the
278 standard Xorg package into the tree in a location needed for modification.
279 </para>
280
281 <para>
282 <parameter>--disable ...</parameter>: Most options that are usually
283 needed for the standard Xorg server are not needed for the Xvnc
284 instance being built.
285 </para>
286
287 <para>
288 <command>[ -e /usr/bin/Xvnc ] || ln ... Xvnc</command>: If the Xvnc server
289 is not installed in the <filename class='directory'>/usr/bin</filename>
290 directory, then create a link so the <command>vncserver</command> script
291 can find it.
292 </para>
293
294 </sect2>
295
296 <sect2 role="configuration">
297 <title>Configuring Tigervnc</title>
298
299 <para revision='sysv'>
300 The default installation of this package makes some changes in the way it
301 is used. The vncserver perl script is placed in /usr/bin/libexec and the
302 server is designed to be run via a systemd style .service file or the
303 vncsession script as the root user. The man page for vncserver is placed
304 in section 8 of the man pages. The new procedures require a display
305 manager to be installed.
306 </para>
307
308 <para revision='sysv'>
309 To restore the previous behavior, install the additional downloaded
310 files as the <systemitem class="username">root</systemitem> user:</para>
311
312<screen role="root" revision='sysv'><userinput>install -m755 --owner=root ../vncserver /usr/bin &amp;&amp;
313cp ../vncserver.1 /usr/share/man/man1</userinput></screen>
314
315 <para revision='sysv'>
316 Using the previous procedures, the user specific configuration files of
317 vncserver reside in the <filename class='directory'>.vnc</filename>
318 directory in the user's home directory. The
319 <filename>xstartup</filename> file in that directory is a script
320 specifying what commands to run when a VNC desktop is started. If no
321 <filename>xstartup</filename> file exists, <command>vncserver</command>
322 will try to start an xterm in a twm session. An example
323 <filename>xstartup</filename> would be:
324 </para>
325
326<screen revision='sysv'>#!/bin/sh
327[ -x /etc/vnc/xstartup ] &amp;&amp; exec /etc/vnc/xstartup
328[ -r $HOME/.Xresources ] &amp;&amp; xrdb $HOME/.Xresources
329startlxde &amp;</screen>
330
331 <para revision='sysv'>
332 The <filename>xstartup</filename> file must be executable for the
333 commands in it to be executed, so run <command>chmod a+x
334 ~/.vnc/xstartup</command>.
335 </para>
336
337 <para revision='sysv'>
338 Set up the vnc passwd with <command>vncpasswd</command>. The
339 server can then be started with the <command>vncserver</command>
340 command.
341 See the man pages in section 1 for the vncserver for the server
342 system and vncviewer for the remote system.
343 </para>
344
345 <bridgehead renderas="sect3" revision="systemd">Server Configuration</bridgehead>
346
347 <!--
348 <note revision="systemd">
349 <para>
350 This section is optional and is only useful if you want to have VNC
351 sessions launch on system startup. Both configuration methods can
352 coexist on the same system.
353 </para>
354 </note>
355 -->
356 <para revision="systemd">
357 On systemd systems, another method of configuration is available.
358 This configuration provides the added benefit of making tigervnc
359 systemd aware for VNC sessions and allows desktop environments like
360 <application>GNOME</application> to autostart services once the VNC
361 session is started. This configuration also gives the added benefit
362 of starting VNC Sessions on system startup. To set up the VNC server
363 in this fashion, follow these instructions.
364 </para>
365
366 <para revision="systemd">
367 First, install a rudimentary Xsession file so that the VNC server
368 can initialize X sessions properly:
369 </para>
370
371<screen role="root" revision="systemd"><userinput>install -vdm755 /etc/X11/tigervnc &amp;&amp;
372install -v -m755 ../Xsession /etc/X11/tigervnc</userinput></screen>
373
374 <para revision="systemd">
375 Next, set up a user mapping in
376 <filename>/etc/tigervnc/vncserver.users</filename>. This tells the VNC
377 Server which session is allocated to a user.
378 <!-- For example: :1=renodr will assign 'renodr' to :1 -->
379 </para>
380
381<screen role="root" revision="systemd"><userinput>echo ":1=$(whoami)" >> /etc/tigervnc/vncserver.users</userinput></screen>
382
383 <para revision="systemd">
384 Next, set up a configuration file to tell
385 <application>vncserver</application> which desktop environment should be
386 used and what display geometry should be used. There are several other
387 options that can be defined in this file, but they are outside the scope
388 of BLFS.
389 </para>
390
391<screen revision="systemd"><userinput>install -vdm 755 ~/.vnc &amp;&amp;
392cat &gt; ~/.vnc/config &lt;&lt; EOF
393<literal># Begin ~/.vnc/config
394# The session must match one listed in /usr/share/xsessions.
395# Ensure that there are no spaces at the end of the lines.
396
397session=lxqt
398geometry=1024x768
399
400# End ~/.vnc/config</literal>
401EOF</userinput></screen>
402
403 <para revision="systemd">
404 To start the VNC Server, run the following command:
405 </para>
406
407<screen role="root" revision="systemd"><userinput>systemctl start vncserver@:1</userinput></screen>
408
409 <para revision="systemd">
410 To start the VNC Server when the system boots, run the following command:
411 </para>
412
413<screen role="root" revision="systemd"><userinput>systemctl enable vncserver@:1</userinput></screen>
414
415 </sect2>
416
417 <sect2 role="content">
418 <title>Contents</title>
419
420 <segmentedlist>
421 <segtitle>Installed Programs</segtitle>
422 <segtitle>Installed Libraries</segtitle>
423 <segtitle>Installed Directories</segtitle>
424
425 <seglistitem>
426 <seg>Xvnc,
427 vncconfig,
428 vncpasswd,
429 vncserver,
430 vncviewer, and
431 x0vncserver</seg>
432
433 <seg>libvnc.so</seg>
434 <seg>/usr/share/doc/tigervnc-&tigervnc-version;</seg>
435 </seglistitem>
436 </segmentedlist>
437
438 <variablelist>
439 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
440 <?dbfo list-presentation="list"?>
441 <?dbhtml list-presentation="table"?>
442
443 <varlistentry id="xvnc">
444 <term><command>Xvnc</command></term>
445 <listitem>
446 <para>
447 is a X VNC (Virtual Network Computing) server.
448 It is based on a standard X server, but it has a
449 <quote>virtual</quote> screen rather than a physical one
450 </para>
451 <indexterm zone="tigervnc xvnc">
452 <primary sortas="b-xvnc">Xvnc</primary>
453 </indexterm>
454 </listitem>
455 </varlistentry>
456
457 <varlistentry id="vncconfig">
458 <term><command>vncconfig</command></term>
459 <listitem>
460 <para>
461 is a program to configure and control a VNC server
462 </para>
463 <indexterm zone="tigervnc vncconfig">
464 <primary sortas="b-vncconfig">vncconfig</primary>
465 </indexterm>
466 </listitem>
467 </varlistentry>
468
469 <varlistentry id="vncpasswd">
470 <term><command>vncpasswd</command></term>
471 <listitem>
472 <para>
473 allows you to set the password used to access VNC desktops
474 </para>
475 <indexterm zone="tigervnc vncpasswd">
476 <primary sortas="b-vncpasswd">vncpasswd</primary>
477 </indexterm>
478 </listitem>
479 </varlistentry>
480
481 <varlistentry id="vncserver">
482 <term><command>vncserver</command></term>
483 <listitem>
484 <para>
485 is a perl script used to start or stop a VNC server
486 </para>
487 <indexterm zone="tigervnc vncserver">
488 <primary sortas="b-vncserver">vncserver</primary>
489 </indexterm>
490 </listitem>
491 </varlistentry>
492
493 <varlistentry id="vncviewer">
494 <term><command>vncviewer</command></term>
495 <listitem>
496 <para>
497 is a client used to connect to VNC desktops
498 </para>
499 <indexterm zone="tigervnc vncviewer">
500 <primary sortas="b-vncviewer">vncviewer</primary>
501 </indexterm>
502 </listitem>
503 </varlistentry>
504
505 <varlistentry id="x0vncserver">
506 <term><command>x0vncserver</command></term>
507 <listitem>
508 <para>
509 is a program to make an X display on a physical
510 terminal accessible via TigerVNC or compatible viewers
511 </para>
512 <indexterm zone="tigervnc x0vncserver">
513 <primary sortas="b-x0vncserver">x0vncserver</primary>
514 </indexterm>
515 </listitem>
516 </varlistentry>
517
518 </variablelist>
519
520 </sect2>
521
522</sect1>
Note: See TracBrowser for help on using the repository browser.