156 lines
5.4 KiB
HTML
156 lines
5.4 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XVFB</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XVFB</H1>
|
|
Section: User Commands (1)<BR>Updated: xorg-server 1.20.9<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
Xvfb - virtual framebuffer X server for X Version 11
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>Xvfb</B>
|
|
|
|
[ option ] ...
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<I>Xvfb</I>
|
|
|
|
is an X server that can run on machines with no display hardware
|
|
and no physical input devices. It emulates a dumb framebuffer using
|
|
virtual memory.
|
|
<P>
|
|
|
|
The primary use of this server was intended to be server testing. The
|
|
fb code for any depth can be exercised with this server
|
|
without the need for real hardware that supports the desired depths.
|
|
The X community has found many other novel uses for <I>Xvfb</I>,
|
|
including testing clients against unusual depths and screen
|
|
configurations, doing batch processing with <I>Xvfb</I> as a background
|
|
rendering engine, load testing, as an aid to porting the X server to a
|
|
new platform, and providing an unobtrusive way to run applications
|
|
that don't really need an X server but insist on having one anyway.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
|
|
In addition to the normal server options described in the <I><A HREF="/cgi-bin/man/man2html?1+Xserver">Xserver</A>(1)</I>
|
|
manual page, <I>Xvfb</I> accepts the following command line switches:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-screen </B><I>screennum</I> <I>WxHxD</I>
|
|
|
|
<DD>
|
|
This option creates screen <I>screennum</I> and sets its width, height,
|
|
and depth to W, H, and D respectively. By default, only screen 0 exists
|
|
and has the dimensions 1280x1024x24.
|
|
<DT id="2"><B>-pixdepths </B><I>list-of-depths</I>
|
|
|
|
<DD>
|
|
This option specifies a list of pixmap depths that the server should
|
|
support in addition to the depths implied by the supported screens.
|
|
<I>list-of-depths</I> is a space-separated list of integers that can
|
|
have values from 1 to 32.
|
|
<DT id="3"><B>-fbdir </B><I>framebuffer-directory</I>
|
|
|
|
<DD>
|
|
This option specifies the directory in which the memory mapped files
|
|
containing the framebuffer memory should be created.
|
|
See FILES.
|
|
This option only exists on machines that have the mmap and msync system
|
|
calls.
|
|
<DT id="4"><B>-shmem</B>
|
|
|
|
<DD>
|
|
This option specifies that the framebuffer should be put in shared memory.
|
|
The shared memory ID for each screen will be printed by the server.
|
|
The shared memory is in xwd format.
|
|
This option only exists on machines that support the System V shared memory
|
|
interface.
|
|
</DL>
|
|
<P>
|
|
|
|
If neither <B>-shmem</B> nor <B>-fbdir</B> is specified,
|
|
the framebuffer memory will be allocated with malloc().
|
|
<DL COMPACT>
|
|
<DT id="5"><B>-linebias </B><I>n</I>
|
|
|
|
<DD>
|
|
This option specifies how to adjust the pixelization of thin lines.
|
|
The value <I>n</I> is a bitmask of octants in which to prefer an axial
|
|
step when the Bresenham error term is exactly zero. See the file
|
|
Xserver/mi/miline.h for more information. This option is probably only useful
|
|
to server developers to experiment with the range of line pixelization
|
|
possible with the fb code.
|
|
<DT id="6"><B>-blackpixel </B><I>pixel-value</I>, -whitepixel <I>pixel-value</I>
|
|
|
|
<DD>
|
|
These options specify the black and white pixel values the server should use.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
The following files are created if the -fbdir option is given.
|
|
<DL COMPACT>
|
|
<DT id="7"><I>framebuffer-directory</I>/Xvfb_screen<n><DD>
|
|
Memory mapped file containing screen n's framebuffer memory, one file
|
|
per screen. The file is in xwd format. Thus, taking a full-screen
|
|
snapshot can be done with a file copy command, and the resulting
|
|
snapshot will even contain the cursor image.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>EXAMPLES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="8">Xvfb :1 -screen 0 1600x1200x24<DD>
|
|
The server will listen for connections as server number 1, and screen 0
|
|
will be depth 24 1600x1200.
|
|
<DT id="9">Xvfb :1 -screen 1 1600x1200x16<DD>
|
|
The server will listen for connections as server number 1, screen 0 will have the
|
|
default screen configuration (1280x1024x24), and screen 1 will be depth 16 1600x1200.
|
|
<DT id="10">Xvfb -pixdepths 3 27 -fbdir /var/tmp<DD>
|
|
The server will listen for connections as server number 0, will have the
|
|
default screen configuration (one screen, 1280x1024x24),
|
|
will also support pixmap
|
|
depths of 3 and 27,
|
|
and will use memory mapped files in /var/tmp for the framebuffer.
|
|
<DT id="11">xwud -in /var/tmp/Xvfb_screen0<DD>
|
|
Displays screen 0 of the server started by the preceding example.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<P>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+X">X</A>(7), <A HREF="/cgi-bin/man/man2html?1+Xserver">Xserver</A>(1), <A HREF="/cgi-bin/man/man2html?1+xwd">xwd</A>(1), <A HREF="/cgi-bin/man/man2html?1+xwud">xwud</A>(1), XWDFile.h
|
|
<A NAME="lbAI"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
David P. Wiggins, The Open Group, Inc.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="12"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="13"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="14"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="15"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="16"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="17"><A HREF="#lbAG">EXAMPLES</A><DD>
|
|
<DT id="18"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
<DT id="19"><A HREF="#lbAI">AUTHORS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:31 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|