414 lines
13 KiB
HTML
414 lines
13 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XRDB</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XRDB</H1>
|
|
Section: User Commands (1)<BR>Updated: xrdb 1.1.1<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>
|
|
|
|
xrdb - X server resource database utility
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>xrdb</B>
|
|
|
|
[-option ...] [<I>filename</I>]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<I>Xrdb</I>
|
|
|
|
is used to get or set the contents of the RESOURCE_MANAGER property
|
|
on the root window of screen 0, or the SCREEN_RESOURCES property on
|
|
the root window of any or all screens, or everything combined.
|
|
You would normally run this program from your X startup file.
|
|
<P>
|
|
|
|
Most X clients use the RESOURCE_MANAGER and SCREEN_RESOURCES properties to
|
|
get user preferences about
|
|
color, fonts, and so on for applications. Having this information in
|
|
the server (where it is available to all clients) instead of on disk,
|
|
solves the problem in previous versions of X that required you to
|
|
maintain <I>defaults</I> files on every machine that you might use.
|
|
It also allows for dynamic changing of defaults without editing files.
|
|
<P>
|
|
|
|
The RESOURCE_MANAGER property is used for resources that apply to all
|
|
screens of the display. The SCREEN_RESOURCES property on each screen
|
|
specifies additional (or overriding) resources to be used for that screen.
|
|
(When there is only one screen, SCREEN_RESOURCES is normally not used,
|
|
all resources are just placed in the RESOURCE_MANAGER property.)
|
|
<P>
|
|
|
|
The file specified by
|
|
<I>filename</I>
|
|
|
|
(or the contents from standard input if - or no filename is given)
|
|
is optionally passed through the C preprocessor with the
|
|
following symbols defined, based on the capabilities of the server
|
|
being used:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>SERVERHOST=</B><I>hostname</I>
|
|
|
|
<DD>
|
|
the hostname portion of the display to which you are connected.
|
|
<DT id="2"><B>SRVR_</B><I>name</I><B></B>
|
|
|
|
<DD>
|
|
the SERVERHOST hostname string turned into a legal identifier.
|
|
For example, "my-dpy.lcs.mit.edu" becomes SRVR_my_dpy_lcs_mit_edu.
|
|
<DT id="3"><B>HOST=</B><I>hostname</I>
|
|
|
|
<DD>
|
|
the same as
|
|
<B>SERVERHOST</B>.
|
|
|
|
<DT id="4"><B>DISPLAY_NUM=</B><I>num</I>
|
|
|
|
<DD>
|
|
the number of the display on the server host.
|
|
<DT id="5"><B>CLIENTHOST=</B><I>hostname</I>
|
|
|
|
<DD>
|
|
the name of the host on which
|
|
<I>xrdb</I>
|
|
|
|
is running.
|
|
<DT id="6"><B>CLNT_</B><I>name</I><B></B>
|
|
|
|
<DD>
|
|
the CLIENTHOST hostname string turned into a legal identifier.
|
|
For example, "expo.lcs.mit.edu" becomes CLNT_expo_lcs_mit_edu.
|
|
<DT id="7"><B>RELEASE=</B><I>num</I>
|
|
|
|
<DD>
|
|
the vendor release number for the server. The interpretation of this
|
|
number will vary depending on VENDOR.
|
|
<DT id="8"><B>REVISION=</B><I>num</I>
|
|
|
|
<DD>
|
|
the X protocol minor version supported by this server (currently 0).
|
|
<DT id="9"><B>VERSION=</B><I>num</I>
|
|
|
|
<DD>
|
|
the X protocol major version supported by this server (should always be 11).
|
|
<DT id="10"><B>VENDOR=</B><I>vendor</I>
|
|
|
|
<DD>
|
|
a string literal specifying the vendor of the server.
|
|
<DT id="11"><B>VNDR_</B><I>name</I>
|
|
|
|
<DD>
|
|
the VENDOR name string turned into a legal identifier.
|
|
For example, "MIT X Consortium" becomes VNDR_MIT_X_Consortium.
|
|
<DT id="12"><B>EXT_</B><I>name</I>
|
|
|
|
<DD>
|
|
A symbol is defined for each protocol extension supported by the server.
|
|
Each extension string name is turned into a legal identifier.
|
|
For example, "X3D-PEX" becomes EXT_X3D_PEX.
|
|
<DT id="13"><B>NUM_SCREENS=</B><I>num</I>
|
|
|
|
<DD>
|
|
the total number of screens.
|
|
<DT id="14"><B>SCREEN_NUM=</B><I>num</I>
|
|
|
|
<DD>
|
|
the number of the current screen (from zero).
|
|
<DT id="15"><B>BITS_PER_RGB=</B><I>num</I>
|
|
|
|
<DD>
|
|
the number of significant bits in an RGB color specification. This is the
|
|
log base 2 of the number of distinct shades of each primary that the hardware
|
|
can generate. Note that it usually is not related to PLANES.
|
|
<DT id="16"><B>CLASS=</B><I>visualclass</I>
|
|
|
|
<DD>
|
|
one of StaticGray, GrayScale, StaticColor, PseudoColor, TrueColor,
|
|
DirectColor. This is the visual class of the root window.
|
|
<DT id="17"><B>CLASS_</B><I>visualclass</I>=<I>visualid</I>
|
|
|
|
<DD>
|
|
the visual class of the root window in a form you can <I>#ifdef</I> on.
|
|
The value is the numeric id of the visual.
|
|
<DT id="18"><B>COLOR</B>
|
|
|
|
<DD>
|
|
defined only if CLASS is one of StaticColor, PseudoColor, TrueColor, or
|
|
DirectColor.
|
|
<DT id="19"><B>CLASS_</B><I>visualclass</I>_<I>depth</I>=<I>num</I>
|
|
|
|
<DD>
|
|
A symbol is defined for each visual supported for the screen.
|
|
The symbol includes the class of the visual and its depth;
|
|
the value is the numeric id of the visual.
|
|
(If more than one visual has the same class and depth, the numeric id
|
|
of the first one reported by the server is used.)
|
|
<DT id="20"><B>HEIGHT=</B><I>num</I>
|
|
|
|
<DD>
|
|
the height of the root window in pixels.
|
|
<DT id="21"><B>WIDTH=</B><I>num</I>
|
|
|
|
<DD>
|
|
the width of the root window in pixels.
|
|
<DT id="22"><B>PLANES=</B><I>num</I>
|
|
|
|
<DD>
|
|
the number of bit planes (the depth) of the root window.
|
|
<DT id="23"><B>X_RESOLUTION=</B><I>num</I>
|
|
|
|
<DD>
|
|
the x resolution of the screen in pixels per meter.
|
|
<DT id="24"><B>Y_RESOLUTION=</B><I>num</I>
|
|
|
|
<DD>
|
|
the y resolution of the screen in pixels per meter.
|
|
</DL>
|
|
<P>
|
|
|
|
SRVR_<I>name</I>, CLNT_<I>name</I>, VNDR_<I>name</I>, and EXT_<I>name</I>
|
|
identifiers are formed by changing all characters other than letters
|
|
and digits into underscores (_).
|
|
<P>
|
|
|
|
Lines that begin with an exclamation mark (!) are ignored and may
|
|
be used as comments.
|
|
<P>
|
|
|
|
Note that since
|
|
<I>xrdb</I>
|
|
|
|
can read from standard input, it can be used to
|
|
the change the contents of properties directly from
|
|
a terminal or from a shell script.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
|
|
<I>xrdb</I>
|
|
|
|
program accepts the following options:
|
|
<DL COMPACT>
|
|
<DT id="25"><B>-help</B>
|
|
|
|
<DD>
|
|
This option (or any unsupported option) will cause a brief description of
|
|
the allowable options and parameters to be printed.
|
|
<DT id="26"><B>-version</B>
|
|
|
|
<DD>
|
|
This option will cause the xrdb version to be printed and the program to exit
|
|
without performing any other operations.
|
|
<DT id="27"><B>-display </B><I>display</I>
|
|
|
|
<DD>
|
|
This option specifies the X server to be used; see <I><A HREF="/cgi-bin/man/man2html?7+X">X</A>(7)</I>.
|
|
It also specifies the screen to use for the <I>-screen</I> option,
|
|
and it specifies the screen from which preprocessor symbols are
|
|
derived for the <I>-global</I> option.
|
|
<DT id="28"><B>-all</B>
|
|
|
|
<DD>
|
|
This option indicates that operation should be performed on the
|
|
screen-independent resource property (RESOURCE_MANAGER), as well as
|
|
the screen-specific property (SCREEN_RESOURCES) on every screen of the
|
|
display. For example, when used in conjunction with <I>-query</I>,
|
|
the contents of all properties are output. For <I>-load</I>, <I>-override</I>
|
|
and <I>-merge</I>,
|
|
the input file is processed once for each screen. The resources which occur
|
|
in common in the output for every screen are collected, and these are applied
|
|
as the screen-independent resources. The remaining resources are applied
|
|
for each individual per-screen property. This the default mode of operation.
|
|
<DT id="29"><B>-global</B>
|
|
|
|
<DD>
|
|
This option indicates that the operation should only be performed on
|
|
the screen-independent RESOURCE_MANAGER property.
|
|
<DT id="30"><B>-screen</B>
|
|
|
|
<DD>
|
|
This option indicates that the operation should only be performed on
|
|
the SCREEN_RESOURCES property of the default screen of the display.
|
|
<DT id="31"><B>-screens</B>
|
|
|
|
<DD>
|
|
This option indicates that the operation should be performed on
|
|
the SCREEN_RESOURCES property of each screen of the display.
|
|
For <I>-load</I>, <I>-override</I> and <I>-merge</I>, the input file is
|
|
processed for each screen.
|
|
<DT id="32"><B>-n</B>
|
|
|
|
<DD>
|
|
This option indicates that changes to the specified properties (when used with
|
|
<I>-load</I>, <I>-override</I> or <I>-merge</I>)
|
|
or to the resource file (when used with <I>-edit</I>) should be shown on the
|
|
standard output, but should not be performed.
|
|
<DT id="33"><B>-quiet</B>
|
|
|
|
<DD>
|
|
This option indicates that warning about duplicate entries should not be
|
|
displayed.
|
|
<DT id="34"><B>-cpp </B><I>filename</I>
|
|
|
|
<DD>
|
|
This option specifies the pathname of the C preprocessor program to be used.
|
|
Although
|
|
<I>xrdb</I>
|
|
|
|
was designed to use CPP, any program that acts as a filter
|
|
and accepts the -D, -I, and -U options may be used.
|
|
<DT id="35"><B>-nocpp</B>
|
|
|
|
<DD>
|
|
This option indicates that
|
|
<I>xrdb</I>
|
|
|
|
should not run the input file through a preprocessor before loading it
|
|
into properties.
|
|
<DT id="36"><B>-undef</B>
|
|
|
|
<DD>
|
|
This option is passed to the C preprocessor if used. It prevents it from
|
|
predefining any system specific macros.
|
|
<DT id="37"><B>-symbols</B>
|
|
|
|
<DD>
|
|
This option indicates that the symbols that are defined for the preprocessor
|
|
should be printed onto the standard output.
|
|
<DT id="38"><B>-query</B>
|
|
|
|
<DD>
|
|
This option indicates that the current contents of the specified
|
|
properties should be printed onto the standard output. Note that since
|
|
preprocessor commands in the input resource file are part of the input
|
|
file, not part of the property, they won't appear in the output from this
|
|
option. The
|
|
<B>-edit</B>
|
|
|
|
option can be used to merge the contents of properties back into the input
|
|
resource file without damaging preprocessor commands.
|
|
<DT id="39"><B>-load</B>
|
|
|
|
<DD>
|
|
This option indicates that the input should be loaded as the new value
|
|
of the specified properties, replacing whatever was there (i.e.
|
|
the old contents are removed). This is the default action.
|
|
<DT id="40"><B>-override</B>
|
|
|
|
<DD>
|
|
This option indicates that the input should be added to, instead of
|
|
replacing, the current contents of the specified properties.
|
|
New entries override previous entries.
|
|
<DT id="41"><B>-merge</B>
|
|
|
|
<DD>
|
|
This option indicates that the input should be merged and lexicographically
|
|
sorted with, instead of replacing, the current contents of the specified
|
|
properties.
|
|
<DT id="42"><B>-remove</B>
|
|
|
|
<DD>
|
|
This option indicates that the specified properties should be removed
|
|
from the server.
|
|
<DT id="43"><B>-retain</B>
|
|
|
|
<DD>
|
|
This option indicates that the server should be instructed not to reset if
|
|
<I>xrdb</I> is the first client. This should never be necessary under normal
|
|
conditions, since <I>xdm</I> and <I>xinit</I> always act as the first client.
|
|
<DT id="44"><B>-edit </B><I>filename</I>
|
|
|
|
<DD>
|
|
This option indicates that the contents of the specified properties
|
|
should be edited into the given file, replacing any values already listed
|
|
there. This allows you to put changes that you have made to your defaults
|
|
back into your resource file, preserving any comments or preprocessor lines.
|
|
<DT id="45"><B>-backup </B><I>string</I>
|
|
|
|
<DD>
|
|
This option specifies a suffix to be appended to the filename used with
|
|
<B>-edit</B>
|
|
|
|
to generate a backup file.
|
|
<DT id="46"><B>-D</B><I>name[=value]</I>
|
|
|
|
<DD>
|
|
This option is passed through to the preprocessor and is used to define
|
|
symbols for use with conditionals such as
|
|
<I>#ifdef.</I>
|
|
|
|
<DT id="47"><B>-U</B><I>name</I>
|
|
|
|
<DD>
|
|
This option is passed through to the preprocessor and is used to remove
|
|
any definitions of this symbol.
|
|
<DT id="48"><B>-I</B><I>directory</I>
|
|
|
|
<DD>
|
|
This option is passed through to the preprocessor and is used to specify
|
|
a directory to search for files that are referenced with
|
|
<I>#include.</I>
|
|
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<I>Xrdb</I>
|
|
|
|
does not load any files on its own, but many desktop environments use
|
|
xrdb to load <I>~/.Xresources</I> files on session startup to initialize
|
|
the resource database, as a generalized replacement for <I>~/.Xdefaults</I>
|
|
files.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+X">X</A>(7), <A HREF="/cgi-bin/man/man2html?1+appres">appres</A>(1), <A HREF="/cgi-bin/man/man2html?1+listres">listres</A>(1),
|
|
Xlib Resource Manager documentation, Xt resource documentation
|
|
<A NAME="lbAH"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="49"><B>DISPLAY</B>
|
|
|
|
<DD>
|
|
to figure out which display to use.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
<P>
|
|
|
|
The default for no arguments should be to query, not to overwrite, so that
|
|
it is consistent with other programs.
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
Bob Scheifler, Phil Karlton, rewritten from the original by Jim Gettys
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="50"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="51"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="52"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="53"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="54"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="55"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
<DT id="56"><A HREF="#lbAH">ENVIRONMENT</A><DD>
|
|
<DT id="57"><A HREF="#lbAI">BUGS</A><DD>
|
|
<DT id="58"><A HREF="#lbAJ">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>
|