NAME

xrdb - X server resource database utility

SYNOPSIS

xrdb [-option ...] [_f_i_l_e_n_a_m_e]

DESCRIPTION

Xrdb 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.

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 _d_e_f_a_u_l_t_s files on every machine that you might use. It also allows for dynamic changing of defaults without editing files.

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.)

The file specified by filename (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:

SERVERHOST=_h_o_s_t_n_a_m_e
the hostname portion of the display to which you are connected.
SRVR__n_a_m_e<> <> tthhee SSEERRVVEERRHHOOSSTT hhoossttnnaammee ssttrriinngg ttuurrnneedd iinnttoo aa lleeggaall iiddeennttiiffiieerr.. FFoorr eexxaammppllee,, ""mmyy--ddppyy..llccss..mmiitt..eedduu"" bbeeccoommeess SSRRVVRR__mmyy__ddppyy__llccss__mmiitt__eedduu.. <> <>HHOOSSTT==_h_o_s_t_n_a_m_e<> <> tthhee ssaammee aass <>SSEERRVVEERRHHOOSSTT<>.. <> <>DDIISSPPLLAAYY__NNUUMM==_n_u_m<> <> tthhee nnuummbbeerr ooff tthhee ddiissppllaayy oonn tthhee sseerrvveerr hhoosstt.. <> <>CCLLIIEENNTTHHOOSSTT==_h_o_s_t_n_a_m_e<> <> tthhee nnaammee ooff tthhee hhoosstt oonn wwhhiicchh <>xxrrddbb<> iiss rruunnnniinngg.. <> <>CCLLNNTT___n_a_m_e<> <> tthhee CCLLIIEENNTTHHOOSSTT hhoossttnnaammee ssttrriinngg ttuurrnneedd iinnttoo aa lleeggaall iiddeennttiiffiieerr.. FFoorr eexxaammppllee,, ""eexxppoo..llccss..mmiitt..eedduu"" bbeeccoommeess CCLLNNTT__eexxppoo__llccss__mmiitt__eedduu.. <> <>RREELLEEAASSEE==_n_u_m<> <> tthhee vveennddoorr rreelleeaassee nnuummbbeerr ffoorr tthhee sseerrvveerr.. TThhee iinntteerrpprreettaattiioonn ooff tthhiiss nnuummbbeerr wwiillll vvaarryy ddeeppeennddiinngg oonn VVEENNDDOORR.. <> <>RREEVVIISSIIOONN==_n_u_m<> <> tthhee XX pprroottooccooll mmiinnoorr vveerrssiioonn ssuuppppoorrtteedd bbyy tthhiiss sseerrvveerr ((ccuurrrreennttllyy 00)).. <> <>VVEERRSSIIOONN==_n_u_m<> <> tthhee XX pprroottooccooll mmaajjoorr vveerrssiioonn ssuuppppoorrtteedd bbyy tthhiiss sseerrvveerr ((sshhoouulldd aallwwaayyss bbee 1111)).. <> <>VVEENNDDOORR==""_v_e_n_d_o_r""<> <> aa ssttrriinngg lliitteerraall ssppeecciiffyyiinngg tthhee vveennddoorr ooff tthhee sseerrvveerr.. <> <>VVNNDDRR___n_a_m_e<> <> tthhee VVEENNDDOORR nnaammee ssttrriinngg ttuurrnneedd iinnttoo aa lleeggaall iiddeennttiiffiieerr.. FFoorr eexxaammppllee,, ""MMIITT XX CCoonnssoorrttiiuumm"" bbeeccoommeess VVNNDDRR__MMIITT__XX__CCoonnssoorrttiiuumm.. <> <>EEXXTT___n_a_m_e<> <> AA ssyymmbbooll iiss ddeeffiinneedd ffoorr eeaacchh pprroottooccooll eexxtteennssiioonn ssuuppppoorrtteedd bbyy tthhee sseerrvveerr.. EEaacchh eexxtteennssiioonn ssttrriinngg nnaammee iiss ttuurrnneedd iinnttoo aa lleeggaall iiddeennttiiffiieerr.. FFoorr eexxaammppllee,, ""XX33DD--PPEEXX"" bbeeccoommeess EEXXTT__XX33DD__PPEEXX.. <> <>NNUUMM__SSCCRREEEENNSS==_n_u_m<> <> tthhee ttoottaall nnuummbbeerr ooff ssccrreeeennss.. <> <>SSCCRREEEENN__NNUUMM==_n_u_m<> <> tthhee nnuummbbeerr ooff tthhee ccuurrrreenntt ssccrreeeenn ((ffrroomm zzeerroo)).. <> <>BBIITTSS__PPEERR__RRGGBB==_n_u_m<> <> tthhee nnuummbbeerr ooff ssiiggnniiffiiccaanntt bbiittss iinn aann RRGGBB ccoolloorr ssppeecciiffiiccaattiioonn.. TThhiiss iiss tthhee lloogg bbaassee 22 ooff tthhee nnuummbbeerr ooff ddiissttiinncctt sshhaaddeess ooff eeaacchh pprriimmaarryy tthhaatt tthhee hhaarrddwwaarree ccaann ggeenneerraattee.. NNoottee tthhaatt iitt uussuuaallllyy iiss nnoott rreellaatteedd ttoo PPLLAANNEESS.. <> <>CCLLAASSSS==_v_i_s_u_a_l_c_l_a_s_s<> <> oonnee ooff SSttaattiiccGGrraayy,, GGrraayySSccaallee,, SSttaattiiccCCoolloorr,, PPsseeuuddooCCoolloorr,, TTrruueeCCoolloorr,, DDiirreeccttCCoolloorr.. TThhiiss iiss tthhee vviissuuaall ccllaassss ooff tthhee rroooott wwiinnddooww.. <> <>CCLLAASSSS___v_i_s_u_a_l_c_l_a_s_s==_v_i_s_u_a_l_i_d<> <> tthhee vviissuuaall ccllaassss ooff tthhee rroooott wwiinnddooww iinn aa ffoorrmm yyoouu ccaann _#_i_f_d_e_f oonn.. TThhee vvaalluuee iiss tthhee nnuummeerriicc iidd ooff tthhee vviissuuaall.. <> <>CCOOLLOORR<> <> ddeeffiinneedd oonnllyy iiff CCLLAASSSS iiss oonnee ooff SSttaattiiccCCoolloorr,, PPsseeuuddooCCoolloorr,, TTrruueeCCoolloorr,, oorr DDiirreeccttCCoolloorr.. <> <>CCLLAASSSS___v_i_s_u_a_l_c_l_a_s_s___d_e_p_t_h==_n_u_m<> <> AA ssyymmbbooll iiss ddeeffiinneedd ffoorr eeaacchh vviissuuaall ssuuppppoorrtteedd ffoorr tthhee ssccrreeeenn.. TThhee ssyymmbbooll iinncclluuddeess tthhee ccllaassss ooff tthhee vviissuuaall aanndd iittss ddeepptthh;; tthhee vvaalluuee iiss tthhee nnuummeerriicc iidd ooff tthhee vviissuuaall.. ((IIff mmoorree tthhaann oonnee vviissuuaall hhaass tthhee ssaammee ccllaassss aanndd ddeepptthh,, tthhee nnuummeerriicc iidd ooff tthhee ffiirrsstt oonnee rreeppoorrtteedd bbyy tthhee sseerrvveerr iiss uusseedd..)) <> <>HHEEIIGGHHTT==_n_u_m<> <> tthhee hheeiigghhtt ooff tthhee rroooott wwiinnddooww iinn ppiixxeellss.. <> <>WWIIDDTTHH==_n_u_m<> <> tthhee wwiiddtthh ooff tthhee rroooott wwiinnddooww iinn ppiixxeellss.. <> <>PPLLAANNEESS==_n_u_m<> <> tthhee nnuummbbeerr ooff bbiitt ppllaanneess ((tthhee ddeepptthh)) ooff tthhee rroooott wwiinnddooww.. <> <>XX__RREESSOOLLUUTTIIOONN==_n_u_m<> <> tthhee xx rreessoolluuttiioonn ooff tthhee ssccrreeeenn iinn ppiixxeellss ppeerr mmeetteerr.. <> <>YY__RREESSOOLLUUTTIIOONN==_n_u_m<> <> tthhee yy rreessoolluuttiioonn ooff tthhee ssccrreeeenn iinn ppiixxeellss ppeerr mmeetteerr.. <> <> SSRRVVRR___n_a_m_e,, CCLLNNTT___n_a_m_e,, VVNNDDRR___n_a_m_e,, aanndd EEXXTT___n_a_m_e iiddeennttiiffiieerrss aarree ffoorrmmeedd bbyy cchhaannggiinngg aallll cchhaarraacctteerrss ootthheerr tthhaann lleetttteerrss aanndd ddiiggiittss iinnttoo uunnddeerrssccoorreess ((__)).. <> LLiinneess tthhaatt bbeeggiinn wwiitthh aann eexxccllaammaattiioonn mmaarrkk ((!!)) aarree iiggnnoorreedd aanndd mmaayy bbee uusseedd aass ccoommmmeennttss.. <> NNoottee tthhaatt ssiinnccee <>xxrrddbb<> ccaann rreeaadd ffrroomm ssttaannddaarrdd iinnppuutt,, iitt ccaann bbee uusseedd ttoo tthhee cchhaannggee tthhee ccoonntteennttss ooff pprrooppeerrttiieess ddiirreeccttllyy ffrroomm aa tteerrmmiinnaall oorr ffrroomm aa sshheellll ssccrriipptt.. <> OOPPTTIIOONNSS <> <> <>xxrrddbb<> pprrooggrraamm aacccceeppttss tthhee ffoolllloowwiinngg ooppttiioonnss:: <> <> <>--hheellpp<> <> TThhiiss ooppttiioonn ((oorr aannyy uunnssuuppppoorrtteedd ooppttiioonn)) wwiillll ccaauussee aa bbrriieeff ddeessccrriippttiioonn ooff tthhee aalllloowwaabbllee ooppttiioonnss aanndd ppaarraammeetteerrss ttoo bbee pprriinntteedd.. <> <>--ddiissppllaayy _d_i_s_p_l_a_y<> <> TThhiiss ooppttiioonn ssppeecciiffiieess tthhee XX sseerrvveerr ttoo bbee uusseedd;; sseeee _X_(_7_).. IItt aallssoo ssppeecciiffiieess tthhee ssccrreeeenn ttoo uussee ffoorr tthhee _-_s_c_r_e_e_n ooppttiioonn,, aanndd iitt ssppeecciiffiieess tthhee ssccrreeeenn ffrroomm wwhhiicchh pprreepprroocceessssoorr ssyymmbboollss aarree ddeerriivveedd ffoorr tthhee _-_g_l_o_b_a_l ooppttiioonn.. <> <>--aallll<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt ooppeerraattiioonn sshhoouulldd bbee ppeerrffoorrmmeedd oonn tthhee ssccrreeeenn--iinnddeeppeennddeenntt rreessoouurrccee pprrooppeerrttyy ((RREESSOOUURRCCEE__MMAANNAAGGEERR)),, aass wweellll aass tthhee ssccrreeeenn--ssppeecciiffiicc pprrooppeerrttyy ((SSCCRREEEENN__RREESSOOUURRCCEESS)) oonn eevveerryy ssccrreeeenn ooff tthhee ddiissppllaayy.. FFoorr eexxaammppllee,, wwhheenn uusseedd iinn ccoonnjjuunnccttiioonn wwiitthh _-_q_u_e_r_y,, tthhee ccoonntteennttss ooff aallll pprrooppeerrttiieess aarree oouuttppuutt.. FFoorr _-_l_o_a_d,, _-_o_v_e_r_r_i_d_e aanndd _-_m_e_r_g_e,, tthhee iinnppuutt ffiillee iiss pprroocceesssseedd oonnccee ffoorr eeaacchh ssccrreeeenn.. TThhee rreessoouurrcceess wwhhiicchh ooccccuurr iinn ccoommmmoonn iinn tthhee oouuttppuutt ffoorr eevveerryy ssccrreeeenn aarree ccoolllleecctteedd,, aanndd tthheessee aarree aapppplliieedd aass tthhee ssccrreeeenn--iinnddeeppeennddeenntt rreessoouurrcceess.. TThhee rreemmaaiinniinngg rreessoouurrcceess aarree aapppplliieedd ffoorr eeaacchh iinnddiivviidduuaall ppeerr--ssccrreeeenn pprrooppeerrttyy.. TThhiiss tthhee ddeeffaauulltt mmooddee ooff ooppeerraattiioonn.. <> <>--gglloobbaall<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee ooppeerraattiioonn sshhoouulldd oonnllyy bbee ppeerrffoorrmmeedd oonn tthhee ssccrreeeenn--iinnddeeppeennddeenntt RREESSOOUURRCCEE__MMAANNAAGGEERR pprrooppeerrttyy.. <> <>--ssccrreeeenn<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee ooppeerraattiioonn sshhoouulldd oonnllyy bbee ppeerrffoorrmmeedd oonn tthhee SSCCRREEEENN__RREESSOOUURRCCEESS pprrooppeerrttyy ooff tthhee ddeeffaauulltt ssccrreeeenn ooff tthhee ddiissppllaayy.. <> <>--ssccrreeeennss<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee ooppeerraattiioonn sshhoouulldd bbee ppeerrffoorrmmeedd oonn tthhee SSCCRREEEENN__RREESSOOUURRCCEESS pprrooppeerrttyy ooff eeaacchh ssccrreeeenn ooff tthhee ddiissppllaayy.. FFoorr _-_l_o_a_d,, _-_o_v_e_r_r_i_d_e aanndd _-_m_e_r_g_e,, tthhee iinnppuutt ffiillee iiss pprroocceesssseedd ffoorr eeaacchh ssccrreeeenn.. <> <>--nn<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt cchhaannggeess ttoo tthhee ssppeecciiffiieedd pprrooppeerrttiieess ((wwhheenn uusseedd wwiitthh _-_l_o_a_d,, _-_o_v_e_r_r_i_d_e oorr _-_m_e_r_g_e)) oorr ttoo tthhee rreessoouurrccee ffiillee ((wwhheenn uusseedd wwiitthh _-_e_d_i_t)) sshhoouulldd bbee sshhoowwnn oonn tthhee ssttaannddaarrdd oouuttppuutt,, bbuutt sshhoouulldd nnoott bbee ppeerrffoorrmmeedd.. <> <>--qquuiieett<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt wwaarrnniinngg aabboouutt dduupplliiccaattee eennttrriieess sshhoouulldd nnoott bbee ddiissppllaayyeedd.. <> <>--ccpppp _f_i_l_e_n_a_m_e<> <> TThhiiss ooppttiioonn ssppeecciiffiieess tthhee ppaatthhnnaammee ooff tthhee CC pprreepprroocceessssoorr pprrooggrraamm ttoo bbee uusseedd.. AAlltthhoouugghh <>xxrrddbb<> wwaass ddeessiiggnneedd ttoo uussee CCPPPP,, aannyy pprrooggrraamm tthhaatt aaccttss aass aa ffiilltteerr aanndd aacccceeppttss tthhee --DD,, --II,, aanndd --UU ooppttiioonnss mmaayy bbee uusseedd.. <> <>--nnooccpppp<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt <>xxrrddbb<> sshhoouulldd nnoott rruunn tthhee iinnppuutt ffiillee tthhrroouugghh aa pprreepprroocceessssoorr bbeeffoorree llooaaddiinngg iitt iinnttoo pprrooppeerrttiieess.. <> <>--ssyymmbboollss<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee ssyymmbboollss tthhaatt aarree ddeeffiinneedd ffoorr tthhee pprreepprroocceessssoorr sshhoouulldd bbee pprriinntteedd oonnttoo tthhee ssttaannddaarrdd oouuttppuutt.. <> <>--qquueerryy<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee ccuurrrreenntt ccoonntteennttss ooff tthhee ssppeecciiffiieedd pprrooppeerrttiieess sshhoouulldd bbee pprriinntteedd oonnttoo tthhee ssttaannddaarrdd oouuttppuutt.. NNoottee tthhaatt ssiinnccee pprreepprroocceessssoorr ccoommmmaannddss iinn tthhee iinnppuutt rreessoouurrccee ffiillee aarree ppaarrtt ooff tthhee iinnppuutt ffiillee,, nnoott ppaarrtt ooff tthhee pprrooppeerrttyy,, tthheeyy wwoonn''tt aappppeeaarr iinn tthhee oouuttppuutt ffrroomm tthhiiss ooppttiioonn.. TThhee <>--eeddiitt<> ooppttiioonn ccaann bbee uusseedd ttoo mmeerrggee tthhee ccoonntteennttss ooff pprrooppeerrttiieess bbaacckk iinnttoo tthhee iinnppuutt rreessoouurrccee ffiillee wwiitthhoouutt ddaammaaggiinngg pprreepprroocceessssoorr ccoommmmaannddss.. <> <>--llooaadd<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee iinnppuutt sshhoouulldd bbee llooaaddeedd aass tthhee nneeww vvaalluuee ooff tthhee ssppeecciiffiieedd pprrooppeerrttiieess,, rreeppllaacciinngg wwhhaatteevveerr wwaass tthheerree ((ii..ee.. tthhee oolldd ccoonntteennttss aarree rreemmoovveedd)).. TThhiiss iiss tthhee ddeeffaauulltt aaccttiioonn.. <> <>--oovveerrrriiddee<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee iinnppuutt sshhoouulldd bbee aaddddeedd ttoo,, iinnsstteeaadd ooff rreeppllaacciinngg,, tthhee ccuurrrreenntt ccoonntteennttss ooff tthhee ssppeecciiffiieedd pprrooppeerrttiieess.. NNeeww eennttrriieess oovveerrrriiddee pprreevviioouuss eennttrriieess.. <> <>--mmeerrggee<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee iinnppuutt sshhoouulldd bbee mmeerrggeedd aanndd lleexxiiccooggrraapphhiiccaallllyy ssoorrtteedd wwiitthh,, iinnsstteeaadd ooff rreeppllaacciinngg,, tthhee ccuurrrreenntt ccoonntteennttss ooff tthhee ssppeecciiffiieedd pprrooppeerrttiieess.. <> <>--rreemmoovvee<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee ssppeecciiffiieedd pprrooppeerrttiieess sshhoouulldd bbee rreemmoovveedd ffrroomm tthhee sseerrvveerr.. <> <>--rreettaaiinn<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee sseerrvveerr sshhoouulldd bbee iinnssttrruucctteedd nnoott ttoo rreesseett iiff _x_r_d_b iiss tthhee ffiirrsstt cclliieenntt.. TThhiiss sshhoouulldd nneevveerr bbee nneecceessssaarryy uunnddeerr nnoorrmmaall ccoonnddiittiioonnss,, ssiinnccee _x_d_m aanndd _x_i_n_i_t aallwwaayyss aacctt aass tthhee ffiirrsstt cclliieenntt.. <> <>--eeddiitt _f_i_l_e_n_a_m_e<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee ccoonntteennttss ooff tthhee ssppeecciiffiieedd pprrooppeerrttiieess sshhoouulldd bbee eeddiitteedd iinnttoo tthhee ggiivveenn ffiillee,, rreeppllaacciinngg aannyy vvaalluueess aallrreeaaddyy lliisstteedd tthheerree.. TThhiiss aalllloowwss yyoouu ttoo ppuutt cchhaannggeess tthhaatt yyoouu hhaavvee mmaaddee ttoo yyoouurr ddeeffaauullttss bbaacckk iinnttoo yyoouurr rreessoouurrccee ffiillee,, pprreesseerrvviinngg aannyy ccoommmmeennttss oorr pprreepprroocceessssoorr lliinneess.. <> <>--bbaacckkuupp _s_t_r_i_n_g<> <> TThhiiss ooppttiioonn ssppeecciiffiieess aa ssuuffffiixx ttoo bbee aappppeennddeedd ttoo tthhee ffiilleennaammee uusseedd wwiitthh <>--eeddiitt<> ttoo ggeenneerraattee aa bbaacckkuupp ffiillee.. <> <>--DD_n_a_m_e_[_=_v_a_l_u_e_]<> <> TThhiiss ooppttiioonn iiss ppaasssseedd tthhrroouugghh ttoo tthhee pprreepprroocceessssoorr aanndd iiss uusseedd ttoo ddeeffiinnee ssyymmbboollss ffoorr uussee wwiitthh ccoonnddiittiioonnaallss ssuucchh aass <>##iiffddeeff..<> <> <>--UU_n_a_m_e<> <> TThhiiss ooppttiioonn iiss ppaasssseedd tthhrroouugghh ttoo tthhee pprreepprroocceessssoorr aanndd iiss uusseedd ttoo rreemmoovvee aannyy ddeeffiinniittiioonnss ooff tthhiiss ssyymmbbooll.. <> <>--II_d_i_r_e_c_t_o_r_y<> <> TThhiiss ooppttiioonn iiss ppaasssseedd tthhrroouugghh ttoo tthhee pprreepprroocceessssoorr aanndd iiss uusseedd ttoo ssppeecciiffyy aa ddiirreeccttoorryy ttoo sseeaarrcchh ffoorr ffiilleess tthhaatt aarree rreeffeerreenncceedd wwiitthh <>##iinncclluuddee..<> <> <> FFIILLEESS <> GGeenneerraalliizzeess _~_/_._X_d_e_f_a_u_l_t_s ffiilleess.. <> SSEEEE AALLSSOO <> XX((77)),, aapppprreess((11)),, lliissttrreess((11)),, XXlliibb RReessoouurrccee MMaannaaggeerr ddooccuummeennttaattiioonn,, XXtt rreessoouurrccee ddooccuummeennttaattiioonn <> EENNVVIIRROONNMMEENNTT <> <> <> <>DDIISSPPLLAAYY<> <> ttoo ffiigguurree oouutt wwhhiicchh ddiissppllaayy ttoo uussee.. <> <> BBUUGGSS <> <> TThhee ddeeffaauulltt ffoorr nnoo aarrgguummeennttss sshhoouulldd bbee ttoo qquueerryy,, nnoott ttoo oovveerrwwrriittee,, ssoo tthhaatt iitt iiss ccoonnssiisstteenntt wwiitthh ootthheerr pprrooggrraammss.. <> AAUUTTHHOORRSS <> BBoobb SScchheeiifflleerr,, PPhhiill KKaarrllttoonn,, rreewwrriitttteenn ffrroomm tthhee oorriiggiinnaall bbyy JJiimm GGeettttyyss <>