home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / xrdb.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  13.0 KB  |  397 lines
  1.  
  2.  
  3.  
  4. XRDB(1)                              XRDB(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        xrdb - X server resource database utility
  9.  
  10. SSYYNNOOPPSSIISS
  11.        xxrrddbb [-option ...] [_f_i_l_e_n_a_m_e]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        _X_r_d_b   is   used     to  get  or  set  the    contents  of  the
  15.        RESOURCE_MANAGER property on the root window of screen  0,
  16.        or the SCREEN_RESOURCES property on the root window of any
  17.        or all screens, or everything combined.     You  would  nor-
  18.        mally run this program from your X startup file.
  19.  
  20.        Most    X    clients    use   the   RESOURCE_MANAGER   and
  21.        SCREEN_RESOURCES properties to get user preferences  about
  22.        color,  fonts,  and  so    on for applications.  Having this
  23.        information in the server (where it is  available  to  all
  24.        clients)     instead of on disk, solves the problem in previ-
  25.        ous versions of X that required you to  maintain     _d_e_f_a_u_l_t_s
  26.        files on every machine that you might use.  It also allows
  27.        for dynamic changing of defaults without editing files.
  28.  
  29.        The RESOURCE_MANAGER property is used for  resources  that
  30.        apply to all screens of the display.  The SCREEN_RESOURCES
  31.        property on each screen specifies additional (or     overrid-
  32.        ing) resources to be used for that screen.  (When there is
  33.        only one screen, SCREEN_RESOURCES is  normally  not  used,
  34.        all  resources  are  just  placed  in the RESOURCE_MANAGER
  35.        property.)
  36.  
  37.        The file specified by _f_i_l_e_n_a_m_e (or the contents from stan-
  38.        dard  input  if    -  or no filename is given) is optionally
  39.        passed through the C preprocessor with the following  sym-
  40.        bols  defined,  based  on  the  capabilities of the server
  41.        being used:
  42.  
  43.        SSEERRVVEERRHHOOSSTT==_h_o_s_t_n_a_m_e
  44.            the hostname portion of the display to  which  you
  45.            are connected.
  46.  
  47.        SSRRVVRR___n_a_m_e
  48.            the SERVERHOST hostname string turned into a legal
  49.            identifier.   For  example,   "my-dpy.lcs.mit.edu"
  50.            becomes SRVR_my_dpy_lcs_mit_edu.
  51.  
  52.        HHOOSSTT==_h_o_s_t_n_a_m_e
  53.            the same as SSEERRVVEERRHHOOSSTT.
  54.  
  55.        DDIISSPPLLAAYY__NNUUMM==_n_u_m
  56.            the number of the display on the server host.
  57.  
  58.        CCLLIIEENNTTHHOOSSTT==_h_o_s_t_n_a_m_e
  59.            the name of the host on which _x_r_d_b is running.
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XRDB(1)                              XRDB(1)
  71.  
  72.  
  73.        CCLLNNTT___n_a_m_e
  74.            the CLIENTHOST hostname string turned into a legal
  75.            identifier.    For   example,   "expo.lcs.mit.edu"
  76.            becomes CLNT_expo_lcs_mit_edu.
  77.  
  78.        RREELLEEAASSEE==_n_u_m
  79.            the  vendor  release  number  for the server.  The
  80.            interpretation of this number will vary    depending
  81.            on VENDOR.
  82.  
  83.        RREEVVIISSIIOONN==_n_u_m
  84.            the  X  protocol     minor    version supported by this
  85.            server (currently 0).
  86.  
  87.        VVEERRSSIIOONN==_n_u_m
  88.            the X protocol major  version  supported     by  this
  89.            server (should always be 11).
  90.  
  91.        VVEENNDDOORR==""_v_e_n_d_o_r""
  92.            a  string  literal  specifying  the  vendor of the
  93.            server.
  94.  
  95.        VVNNDDRR___n_a_m_e
  96.            the VENDOR name string turned into a legal identi-
  97.            fier.   For  example,  "MIT  X Consortium" becomes
  98.            VNDR_MIT_X_Consortium.
  99.  
  100.        EEXXTT___n_a_m_e
  101.            A symbol is defined for    each  protocol    extension
  102.            supported  by  the  server.  Each extension string
  103.            name is turned into a legal identifier.    For exam-
  104.            ple, "X3D-PEX" becomes EXT_X3D_PEX.
  105.  
  106.        NNUUMM__SSCCRREEEENNSS==_n_u_m
  107.            the total number of screens.
  108.  
  109.        SSCCRREEEENN__NNUUMM==_n_u_m
  110.            the number of the current screen (from zero).
  111.  
  112.        BBIITTSS__PPEERR__RRGGBB==_n_u_m
  113.            the  number  of    significant  bits in an RGB color
  114.            specification.  This is the log base 2 of the num-
  115.            ber  of    distinct  shades of each primary that the
  116.            hardware can generate.  Note that  it  usually  is
  117.            not related to PLANES.
  118.  
  119.        CCLLAASSSS==_v_i_s_u_a_l_c_l_a_s_s
  120.            one of StaticGray, GrayScale, StaticColor, Pseudo-
  121.            Color, TrueColor, DirectColor.  This is the visual
  122.            class of the root window.
  123.  
  124.        CCLLAASSSS___v_i_s_u_a_l_c_l_a_s_s==_v_i_s_u_a_l_i_d
  125.            the  visual class of the root window in a form you
  126.            can _#_i_f_d_e_f on.  The value is the numeric id of the
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XRDB(1)                              XRDB(1)
  137.  
  138.  
  139.            visual.
  140.  
  141.        CCOOLLOORR   defined only if CLASS is one of StaticColor, Pseu-
  142.            doColor, TrueColor, or DirectColor.
  143.  
  144.        CCLLAASSSS___v_i_s_u_a_l_c_l_a_s_s___d_e_p_t_h==_n_u_m
  145.            A symbol is defined for each visual supported  for
  146.            the  screen.  The symbol includes the class of the
  147.            visual and its depth; the value is the numeric  id
  148.            of  the    visual.     (If more than one visual has the
  149.            same class and depth, the numeric id of the  first
  150.            one reported by the server is used.)
  151.  
  152.        HHEEIIGGHHTT==_n_u_m
  153.            the height of the root window in pixels.
  154.  
  155.        WWIIDDTTHH==_n_u_m
  156.            the width of the root window in pixels.
  157.  
  158.        PPLLAANNEESS==_n_u_m
  159.            the  number  of bit planes (the depth) of the root
  160.            window.
  161.  
  162.        XX__RREESSOOLLUUTTIIOONN==_n_u_m
  163.            the x resolution     of  the  screen  in  pixels  per
  164.            meter.
  165.  
  166.        YY__RREESSOOLLUUTTIIOONN==_n_u_m
  167.            the  y  resolution  of  the  screen  in pixels per
  168.            meter.
  169.  
  170.        SRVR__n_a_m_e, CLNT__n_a_m_e, VNDR__n_a_m_e, and EXT__n_a_m_e  identifiers
  171.        are  formed  by changing all characters other than letters
  172.        and digits into underscores (_).
  173.  
  174.        Lines that begin with an exclamation mark (!) are  ignored
  175.        and may be used as comments.
  176.  
  177.        Note  that since _x_r_d_b can read from standard input, it can
  178.        be used to the change the contents of properties     directly
  179.        from a terminal or from a shell script.
  180.  
  181. OOPPTTIIOONNSS
  182.        _x_r_d_b program accepts the following options:
  183.  
  184.        --hheellpp   This option (or any unsupported option) will cause
  185.            a brief description of the allowable  options  and
  186.            parameters to be printed.
  187.  
  188.        --ddiissppllaayy _d_i_s_p_l_a_y
  189.            This option specifies the X server to be used; see
  190.            _X_(_1_).  It also specifies the screen to use for the
  191.            _-_s_c_r_e_e_n    option,     and it specifies the screen from
  192.            which preprocessor symbols  are    derived     for  the
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XRDB(1)                              XRDB(1)
  203.  
  204.  
  205.            _-_g_l_o_b_a_l option.
  206.  
  207.        --aallll    This  option  indicates    that  operation should be
  208.            performed on the screen-independent resource prop-
  209.            erty  (RESOURCE_MANAGER),  as  well as the screen-
  210.            specific     property  (SCREEN_RESOURCES)  on   every
  211.            screen  of the display.    For example, when used in
  212.            conjunction with _-_q_u_e_r_y, the contents of all prop-
  213.            erties  are  output.   For  _-_l_o_a_d,  _-_o_v_e_r_r_i_d_e  and
  214.            _-_m_e_r_g_e, the input file is processed once for  each
  215.            screen.     The  resources     which occur in common in
  216.            the output for every  screen  are  collected,  and
  217.            these   are   applied  as  the  screen-independent
  218.            resources.  The remaining  resources  are  applied
  219.            for each individual per-screen property.     This the
  220.            default mode of operation.
  221.  
  222.        --gglloobbaall This option indicates that  the    operation  should
  223.            only   be   performed  on  the  screen-independent
  224.            RESOURCE_MANAGER property.
  225.  
  226.        --ssccrreeeenn This option indicates that  the    operation  should
  227.            only be performed on the SCREEN_RESOURCES property
  228.            of the default screen of the display.
  229.  
  230.        --ssccrreeeennss
  231.            This option indicates that the operation should be
  232.            performed on the SCREEN_RESOURCES property of each
  233.            screen of the display.  For _-_l_o_a_d,  _-_o_v_e_r_r_i_d_e  and
  234.            _-_m_e_r_g_e,    the  input  file  is  processed     for each
  235.            screen.
  236.  
  237.        --nn      This option indicates that changes to  the  speci-
  238.            fied  properties     (when used with _-_l_o_a_d, _-_o_v_e_r_r_i_d_e
  239.            or _-_m_e_r_g_e) or to the resource file (when used with
  240.            _-_e_d_i_t) should be shown on the standard output, but
  241.            should not be performed.
  242.  
  243.        --qquuiieett  This option indicates that warning about duplicate
  244.            entries should not be displayed.
  245.  
  246.        --ccpppp _f_i_l_e_n_a_m_e
  247.            This  option  specifies the pathname of the C pre-
  248.            processor program to be used.  Although    _x_r_d_b  was
  249.            designed     to  use  CPP, any program that acts as a
  250.            filter and accepts the -D, -I, and -U options  may
  251.            be used.
  252.  
  253.        --nnooccpppp  This option indicates that _x_r_d_b should not run the
  254.            input file through a preprocessor  before  loading
  255.            it into properties.
  256.  
  257.        --ssyymmbboollss
  258.            This  option  indicates    that the symbols that are
  259.  
  260.  
  261.  
  262. X Version 11           Release 6.1                4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. XRDB(1)                              XRDB(1)
  269.  
  270.  
  271.            defined for the    preprocessor  should  be  printed
  272.            onto the standard output.
  273.  
  274.        --qquueerryy  This option indicates that the current contents of
  275.            the specified properties should    be  printed  onto
  276.            the standard output.  Note that since preprocessor
  277.            commands in the input resource file  are     part  of
  278.            the  input  file,  not  part of the property, they
  279.            won't appear in the output from this option.   The
  280.            --eeddiitt  option can be used to merge the contents of
  281.            properties back into the input resource file with-
  282.            out damaging preprocessor commands.
  283.  
  284.        --llooaadd   This  option  indicates    that  the input should be
  285.            loaded as the new value of the  specified  proper-
  286.            ties,  replacing whatever was there (i.e.  the old
  287.            contents     are  removed).      This    is  the      default
  288.            action.
  289.  
  290.        --oovveerrrriiddee
  291.            This  option  indicates    that  the input should be
  292.            added to, instead of replacing, the  current  con-
  293.            tents  of  the  specified properties.  New entries
  294.            override previous entries.
  295.  
  296.        --mmeerrggee  This option indicates that  the    input  should  be
  297.            merged  and lexicographically sorted with, instead
  298.            of replacing, the current contents of  the  speci-
  299.            fied properties.
  300.  
  301.        --rreemmoovvee This  option  indicates that the specified proper-
  302.            ties should be removed from the server.
  303.  
  304.        --rreettaaiinn This option indicates that the  server  should  be
  305.            instructed  not    to  reset  if  _x_r_d_b  is the first
  306.            client.    This never be necessary under normal con-
  307.            ditions,     since    _x_d_m  and  _x_i_n_i_t always act as the
  308.            first client.
  309.  
  310.        --eeddiitt _f_i_l_e_n_a_m_e
  311.            This option indicates that  the    contents  of  the
  312.            specified  properties  should  be  edited into the
  313.            given file, replacing any  values  already  listed
  314.            there.    This  allows  you to put changes that you
  315.            have made to your defaults back into your resource
  316.            file,  preserving  any  comments     or  preprocessor
  317.            lines.
  318.  
  319.        --bbaacckkuupp _s_t_r_i_n_g
  320.            This option specifies a suffix to be  appended  to
  321.            the  filename used with --eeddiitt to generate a backup
  322.            file.
  323.  
  324.  
  325.  
  326.  
  327.  
  328. X Version 11           Release 6.1                5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. XRDB(1)                              XRDB(1)
  335.  
  336.  
  337.        --DD_n_a_m_e_[_=_v_a_l_u_e_]
  338.            This option is passed through to the  preprocessor
  339.            and  is used to define symbols for use with condi-
  340.            tionals such as
  341.  
  342.        --UU_n_a_m_e  This option is passed through to the  preprocessor
  343.            and is used to remove any definitions of this sym-
  344.            bol.
  345.  
  346.        --II_d_i_r_e_c_t_o_r_y
  347.            This option is passed through to the  preprocessor
  348.            and  is    used to specify a directory to search for
  349.            files that are referenced with _#_i_n_c_l_u_d_e_.
  350.  
  351. FFIILLEESS
  352.        Generalizes _~_/_._X_d_e_f_a_u_l_t_s files.
  353.  
  354. SSEEEE AALLSSOO
  355.        X(1), Xlib Resource  Manager  documentation,  Xt     resource
  356.        documentation
  357.  
  358. EENNVVIIRROONNMMEENNTT
  359.        DDIISSPPLLAAYY to figure out which display to use.
  360.  
  361. BBUUGGSS
  362.        The  default  for  no arguments should be to query, not to
  363.        overwrite, so that it is consistent with other programs.
  364.  
  365. AAUUTTHHOORRSS
  366.        Bob Scheifler, Phil Karlton, rewritten from  the     original
  367.        by Jim Gettys
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394. X Version 11           Release 6.1                6
  395.  
  396.  
  397.