NAME

xmodmap - utility for modifying keymaps and pointer button mappings in X

SYNOPSIS

xmodmap [-options ...] [filename]

DESCRIPTION

The _x_m_o_d_m_a_p program is used to edit and display the keyboard _m_o_d_i_f_i_e_r _m_a_p and _k_e_y_m_a_p _t_a_b_l_e that are used by client applications to convert event keycodes into keysyms. It is usually run from the user's session startup script to configure the keyboard according to personal tastes.

OPTIONS

The following options may be used with _x_m_o_d_m_a_p:

-display _d_i_s_p_l_a_y
This option specifies the host and display to use.
-help
This option indicates that a brief description of the command line arguments should be printed on the standard error channel. This will be done whenever an unhandled argument is given to xmodmap.
-grammar
This option indicates that a help message describing the expression grammar used in files and with -e expressions should be printed on the standard error.
-verbose
This option indicates that xmodmap should print logging information as it parses its input.
-quiet
This option turns off the verbose logging. This is the default.
-n
This option indicates that xmodmap should not change the mappings, but should display what it would do, like _m_a_k_e_(_1_) does when given this option.
-e _e_x_p_r_e_s_s_i_o_n<> <> TThhiiss ooppttiioonn ssppeecciiffiieess aann eexxpprreessssiioonn ttoo bbee eexxeeccuutteedd.. AAnnyy nnuummbbeerr ooff eexxpprreessssiioonnss mmaayy bbee ssppeecciiffiieedd ffrroomm tthhee ccoommmmaanndd lliinnee.. <> <>--ppmm<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee ccuurrrreenntt mmooddiiffiieerr mmaapp sshhoouulldd bbee pprriinntteedd oonn tthhee ssttaannddaarrdd oouuttppuutt.. <> <>--ppkk<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee ccuurrrreenntt kkeeyymmaapp ttaabbllee sshhoouulldd bbee pprriinntteedd oonn tthhee ssttaannddaarrdd oouuttppuutt.. <> <>--ppkkee<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee ccuurrrreenntt kkeeyymmaapp ttaabbllee sshhoouulldd bbee pprriinntteedd oonn tthhee ssttaannddaarrdd oouuttppuutt iinn tthhee ffoorrmm ooff eexxpprreessssiioonnss tthhaatt ccaann bbee ffeedd bbaacckk ttoo _x_m_o_d_m_a_p.. <> <>--pppp<> <> TThhiiss ooppttiioonn iinnddiiccaatteess tthhaatt tthhee ccuurrrreenntt ppooiinntteerr mmaapp sshhoouulldd bbee pprriinntteedd oonn tthhee ssttaannddaarrdd oouuttppuutt.. <> <>--<> <> AA lloonnee ddaasshh mmeeaannss tthhaatt tthhee ssttaannddaarrdd iinnppuutt sshhoouulldd bbee uusseedd aass tthhee iinnppuutt ffiillee.. <> <> TThhee _f_i_l_e_n_a_m_e ssppeecciiffiieess aa ffiillee ccoonnttaaiinniinngg _x_m_o_d_m_a_p eexxpprreessssiioonnss ttoo bbee eexxeeccuutteedd.. TThhiiss ffiillee iiss uussuuaallllyy kkeepptt iinn tthhee uusseerr''ss hhoommee ddiirreeccttoorryy wwiitthh aa nnaammee lliikkee _._x_m_o_d_m_a_p_r_c.. <> EEXXPPRREESSSSIIOONN GGRRAAMMMMAARR <> <> TThhee <>xxmmooddmmaapp<> pprrooggrraamm rreeaaddss aa lliisstt ooff eexxpprreessssiioonnss aanndd ppaarrsseess tthheemm aallll bbeeffoorree aatttteemmppttiinngg ttoo eexxeeccuuttee aannyy ooff tthheemm.. TThhiiss mmaakkeess iitt ppoossssiibbllee ttoo rreeffeerr ttoo kkeeyyssyymmss tthhaatt aarree bbeeiinngg rreeddeeffiinneedd iinn aa nnaattuurraall wwaayy wwiitthhoouutt hhaavviinngg ttoo wwoorrrryy aass mmuucchh aabboouutt nnaammee ccoonnfflliiccttss.. <> <> <>kkeeyyccooddee _N_U_M_B_E_R == _K_E_Y_S_Y_M_N_A_M_E _._._.<> <> TThhee lliisstt ooff kkeeyyssyymmss iiss aassssiiggnneedd ttoo tthhee iinnddiiccaatteedd kkeeyyccooddee ((wwhhiicchh mmaayy bbee ssppeecciiffiieedd iinn ddeecciimmaall,, hheexx oorr ooccttaall aanndd ccaann bbee ddeetteerrmmiinneedd bbyy rruunnnniinngg tthhee <>xxeevv<> pprrooggrraamm)).. UUpp ttoo eeiigghhtt kkeeyyssyymmss mmaayy bbee aattttaacchheedd ttoo aa kkeeyy,, hhoowweevveerr tthhee llaasstt ffoouurr aarree nnoott uusseedd iinn aannyy mmaajjoorr XX sseerrvveerr iimmpplleemmeennttaattiioonn.. TThhee ffiirrsstt kkeeyyssyymm iiss uusseedd wwhheenn nnoo mmooddiiffiieerr kkeeyy iiss pprreesssseedd iinn ccoonnjjuunnccttiioonn wwiitthh tthhiiss kkeeyy,, tthhee sseeccoonndd wwiitthh SShhiifftt,, tthhee tthhiirrdd wwhheenn tthhee MMooddee__sswwiittcchh kkeeyy iiss uusseedd wwiitthh tthhiiss kkeeyy aanndd tthhee ffoouurrtthh wwhheenn bbootthh tthhee MMooddee__sswwiittcchh aanndd SShhiifftt kkeeyyss aarree uusseedd.. <> <>kkeeyyccooddee aannyy == _K_E_Y_S_Y_M_N_A_M_E _._._.<> <> IIff nnoo eexxiissttiinngg kkeeyy hhaass tthhee ssppeecciiffiieedd lliisstt ooff kkeeyyssyymmss aassssiiggnneedd ttoo iitt,, aa ssppaarree kkeeyy oonn tthhee kkeeyybbooaarrdd iiss sseelleecctteedd aanndd tthhee kkeeyyssyymmss aarree aassssiiggnneedd ttoo iitt.. TThhee lliisstt ooff kkeeyyssyymmss mmaayy bbee ssppeecciiffiieedd iinn ddeecciimmaall,, hheexx oorr ooccttaall.. <> <>kkeeyyssyymm _K_E_Y_S_Y_M_N_A_M_E == _K_E_Y_S_Y_M_N_A_M_E _._._.<> <> TThhee _K_E_Y_S_Y_M_N_A_M_E oonn tthhee lleefftt hhaanndd ssiiddee iiss ttrraannssllaatteedd iinnttoo mmaattcchhiinngg kkeeyyccooddeess uusseedd ttoo ppeerrffoorrmm tthhee ccoorrrreessppoonnddiinngg sseett ooff kkeeyyccooddee eexxpprreessssiioonnss.. TThhee lliisstt ooff kkeeyyssyymm nnaammeess mmaayy bbee ffoouunndd iinn tthhee hheeaaddeerr ffiillee _<_X_1_1_/_k_e_y_s_y_m_d_e_f_._h_> ((wwiitthhoouutt tthhee _X_K__ pprreeffiixx)) oorr tthhee kkeeyyssyymm ddaattaabbaassee _/_u_s_r_/_X_1_1_R_6_/_l_i_b_/_X_1_1_/_X_K_e_y_s_y_m_D_B.. NNoottee tthhaatt iiff tthhee ssaammee kkeeyyssyymm iiss bboouunndd ttoo mmuullttiippllee kkeeyyss,, tthhee eexxpprreessssiioonn iiss eexxeeccuutteedd ffoorr eeaacchh mmaattcchhiinngg kkeeyyccooddee.. <> <>cclleeaarr _M_O_D_I_F_I_E_R_N_A_M_E<> <> TThhiiss rreemmoovveess aallll eennttrriieess iinn tthhee mmooddiiffiieerr mmaapp ffoorr tthhee ggiivveenn mmooddiiffiieerr,, wwhheerree vvaalliidd nnaammee aarree:: <>SShhiifftt<>,, <>LLoocckk<>,, <>CCoonnttrrooll<>,, <>MMoodd11<>,, <>MMoodd22<>,, <>MMoodd33<>,, <>MMoodd44<>,, aanndd MMoodd55 ((ccaassee ddooeess nnoott mmaatttteerr iinn mmooddiiffiieerr nnaammeess,, aalltthhoouugghh iitt ddooeess mmaatttteerr ffoorr aallll ootthheerr nnaammeess)).. FFoorr eexxaammppllee,, ````cclleeaarr LLoocckk'''' wwiillll rreemmoovvee aallll aannyy kkeeyyss tthhaatt wweerree bboouunndd ttoo tthhee sshhiifftt lloocckk mmooddiiffiieerr.. <> <>aadddd _M_O_D_I_F_I_E_R_N_A_M_E == _K_E_Y_S_Y_M_N_A_M_E _._._.<> <> TThhiiss aaddddss aallll kkeeyyss ccoonnttaaiinniinngg tthhee ggiivveenn kkeeyyssyymmss ttoo tthhee iinnddiiccaatteedd mmooddiiffiieerr mmaapp.. TThhee kkeeyyssyymm nnaammeess aarree eevvaalluuaatteedd aafftteerr aallll iinnppuutt eexxpprreessssiioonnss aarree rreeaadd ttoo mmaakkee iitt eeaassyy ttoo wwrriittee eexxpprreessssiioonnss ttoo sswwaapp kkeeyyss ((sseeee tthhee EEXXAAMMPPLLEESS sseeccttiioonn)).. <> <>rreemmoovvee _M_O_D_I_F_I_E_R_N_A_M_E == _K_E_Y_S_Y_M_N_A_M_E _._._.<> <> TThhiiss rreemmoovveess aallll kkeeyyss ccoonnttaaiinniinngg tthhee ggiivveenn kkeeyyssyymmss ffrroomm tthhee iinnddiiccaatteedd mmooddiiffiieerr mmaapp.. UUnnlliikkee <>aadddd,,<> tthhee kkeeyyssyymm nnaammeess aarree eevvaalluuaatteedd aass tthhee lliinnee iiss rreeaadd iinn.. TThhiiss aalllloowwss yyoouu ttoo rreemmoovvee kkeeyyss ffrroomm aa mmooddiiffiieerr wwiitthhoouutt hhaavviinngg ttoo wwoorrrryy aabboouutt wwhheetthheerr oorr nnoott tthheeyy hhaavvee bbeeeenn rreeaassssiiggnneedd.. <> <>ppooiinntteerr == ddeeffaauulltt<> <> TThhiiss sseettss tthhee ppooiinntteerr mmaapp bbaacckk ttoo iittss ddeeffaauulltt sseettttiinnggss ((bbuuttttoonn 11 ggeenneerraatteess aa ccooddee ooff 11,, bbuuttttoonn 22 ggeenneerraatteess aa 22,, eettcc..)).. <> <>ppooiinntteerr == _N_U_M_B_E_R _._._.<> <> TThhiiss sseettss tthhee ppooiinntteerr mmaapp ttoo ccoonnttaaiinn tthhee iinnddiiccaatteedd bbuuttttoonn ccooddeess.. TThhee lliisstt aallwwaayyss ssttaarrttss wwiitthh tthhee ffiirrsstt pphhyyssiiccaall bbuuttttoonn.. <> <> LLiinneess tthhaatt bbeeggiinn wwiitthh aann eexxccllaammaattiioonn ppooiinntt ((!!)) aarree ttaakkeenn aass ccoommmmeennttss.. <> IIff yyoouu wwaanntt ttoo cchhaannggee tthhee bbiinnddiinngg ooff aa mmooddiiffiieerr kkeeyy,, yyoouu mmuusstt aallssoo rreemmoovvee iitt ffrroomm tthhee aapppprroopprriiaattee mmooddiiffiieerr mmaapp.. <> EEXXAAMMPPLLEESS <> <> MMaannyy ppooiinntteerrss aarree ddeessiiggnneedd ssuucchh tthhaatt tthhee ffiirrsstt bbuuttttoonn iiss pprreesssseedd uussiinngg tthhee iinnddeexx ffiinnggeerr ooff tthhee rriigghhtt hhaanndd.. PPeeooppllee wwhhoo aarree lleefftt--hhaannddeedd ffrreeqquueennttllyy ffiinndd tthhaatt iitt iiss mmoorree ccoommffoorrttaabbllee ttoo rreevveerrssee tthhee bbuuttttoonn ccooddeess tthhaatt ggeett ggeenneerraatteedd ssoo tthhaatt tthhee pprriimmaarryy bbuuttttoonn iiss pprreesssseedd uussiinngg tthhee iinnddeexx ffiinnggeerr ooff tthhee lleefftt hhaanndd.. TThhiiss ccoouulldd bbee ddoonnee oonn aa 33 bbuuttttoonn ppooiinntteerr aass ffoolllloowwss:: <><> <> <> %% xxmmooddmmaapp --ee ""ppooiinntteerr == 33 22 11"" <> <><> <> MMaannyy aapppplliiccaattiioonnss ssuuppppoorrtt tthhee nnoottiioonn ooff MMeettaa kkeeyyss ((ssiimmiillaarr ttoo CCoonnttrrooll kkeeyyss eexxcceepptt tthhaatt MMeettaa iiss hheelldd ddoowwnn iinnsstteeaadd ooff CCoonnttrrooll)).. HHoowweevveerr,, ssoommee sseerrvveerrss ddoo nnoott hhaavvee aa MMeettaa kkeeyyssyymm iinn tthhee ddeeffaauulltt kkeeyymmaapp ttaabbllee,, ssoo oonnee nneeeeddss ttoo bbee aaddddeedd bbyy hhaanndd.. TThhee ffoolllloowwiinngg ccoommmmaanndd wwiillll aattttaacchh MMeettaa ttoo tthhee MMuullttii--llaanngguuaaggee kkeeyy ((ssoommeettiimmeess llaabbeelleedd CCoommppoossee CChhaarraacctteerr)).. IItt aallssoo ttaakkeess aaddvvaannttaaggee ooff tthhee ffaacctt tthhaatt aapppplliiccaattiioonnss tthhaatt nneeeedd aa MMeettaa kkeeyy ssiimmppllyy nneeeedd ttoo ggeett tthhee kkeeyyccooddee aanndd ddoonn''tt rreeqquuiirree tthhee kkeeyyssyymm ttoo bbee iinn tthhee ffiirrsstt ccoolluummnn ooff tthhee kkeeyymmaapp ttaabbllee.. TThhiiss mmeeaannss tthhaatt aapppplliiccaattiioonnss tthhaatt aarree llooookkiinngg ffoorr aa MMuullttii__kkeeyy ((iinncclluuddiinngg tthhee ddeeffaauulltt mmooddiiffiieerr mmaapp)) wwoonn''tt nnoottiiccee aannyy cchhaannggee.. <><> <> <> %% xxmmooddmmaapp --ee ""kkeeyyssyymm MMuullttii__kkeeyy == MMuullttii__kkeeyy MMeettaa__LL"" <> <><> <> SSiimmiillaarrllyy,, ssoommee kkeeyybbooaarrddss hhaavvee aann AAlltt kkeeyy bbuutt nnoo MMeettaa kkeeyy.. IInn tthhaatt ccaassee tthhee ffoolllloowwiinngg mmaayy bbee uusseeffuull:: <><> <> <> %% xxmmooddmmaapp --ee ""kkeeyyssyymm AAlltt__LL == MMeettaa__LL AAlltt__LL"" <> <><> <> OOnnee ooff tthhee mmoorree ssiimmppllee,, yyeett ccoonnvveenniieenntt,, uusseess ooff _x_m_o_d_m_a_p iiss ttoo sseett tthhee kkeeyybbooaarrdd''ss ""rruubboouutt"" kkeeyy ttoo ggeenneerraattee aann aalltteerrnnaattee kkeeyyssyymm.. TThhiiss ffrreeqquueennttllyy iinnvvoollvveess eexxcchhaannggiinngg BBaacckkssppaaccee wwiitthh DDeelleettee ttoo bbee mmoorree ccoommffoorrttaabbllee ttoo tthhee uusseerr.. IIff tthhee _t_t_y_M_o_d_e_s rreessoouurrccee iinn _x_t_e_r_m iiss sseett aass wweellll,, aallll tteerrmmiinnaall eemmuullaattoorr wwiinnddoowwss wwiillll uussee tthhee ssaammee kkeeyy ffoorr eerraassiinngg cchhaarraacctteerrss:: <><> <> <> %% xxmmooddmmaapp --ee ""kkeeyyssyymm BBaacckkSSppaaccee == DDeelleettee"" %% eecchhoo ""XXTTeerrmm**ttttyyMMooddeess:: eerraassee ^^??"" || xxrrddbb --mmeerrggee <> <><> <> SSoommee kkeeyybbooaarrddss ddoo nnoott aauuttoommaattiiccaallllyy ggeenneerraattee lleessss tthhaann aanndd ggrreeaatteerr tthhaann cchhaarraacctteerrss wwhheenn tthhee ccoommmmaa aanndd ppeerriioodd kkeeyyss aarree sshhiifftteedd.. TThhiiss ccaann bbee rreemmeeddiieedd wwiitthh _x_m_o_d_m_a_p bbyy rreesseettttiinngg tthhee bbiinnddiinnggss ffoorr tthhee ccoommmmaa aanndd ppeerriioodd wwiitthh tthhee ffoolllloowwiinngg ssccrriippttss:: <><> <> <> !! !! mmaakkee sshhiifftt--,, bbee << aanndd sshhiifftt--.. bbee >> !! kkeeyyssyymm ccoommmmaa == ccoommmmaa lleessss kkeeyyssyymm ppeerriioodd == ppeerriioodd ggrreeaatteerr <> <><> <> OOnnee ooff tthhee mmoorree iirrrriittaattiinngg ddiiffffeerreenncceess bbeettwweeeenn kkeeyybbooaarrddss iiss tthhee llooccaattiioonn ooff tthhee CCoonnttrrooll aanndd SShhiifftt LLoocckk kkeeyyss.. AA ccoommmmoonn uussee ooff _x_m_o_d_m_a_p iiss ttoo sswwaapp tthheessee ttwwoo kkeeyyss aass ffoolllloowwss:: <><> <> <> !! !! SSwwaapp CCaappss__LLoocckk aanndd CCoonnttrrooll__LL !! rreemmoovvee LLoocckk == CCaappss__LLoocckk rreemmoovvee CCoonnttrrooll == CCoonnttrrooll__LL kkeeyyssyymm CCoonnttrrooll__LL == CCaappss__LLoocckk kkeeyyssyymm CCaappss__LLoocckk == CCoonnttrrooll__LL aadddd LLoocckk == CCaappss__LLoocckk aadddd CCoonnttrrooll == CCoonnttrrooll__LL <> <><> <> TThhee _k_e_y_c_o_d_e ccoommmmaanndd iiss uusseeffuull ffoorr aassssiiggnniinngg tthhee ssaammee kkeeyyssyymm ttoo mmuullttiippllee kkeeyyccooddeess.. AAlltthhoouugghh uunnppoorrttaabbllee,, iitt aallssoo mmaakkeess iitt ppoossssiibbllee ttoo wwrriittee ssccrriippttss tthhaatt ccaann rreesseett tthhee kkeeyybbooaarrdd ttoo aa kknnoowwnn ssttaattee.. TThhee ffoolllloowwiinngg ssccrriipptt sseettss tthhee bbaacckkssppaaccee kkeeyy ttoo ggeenneerraattee DDeelleettee ((aass sshhoowwnn aabboovvee)),, fflluusshheess aallll eexxiissttiinngg ccaappss lloocckk bbiinnddiinnggss,, mmaakkeess tthhee CCaappssLLoocckk kkeeyy bbee aa ccoonnttrrooll kkeeyy,, mmaakkee FF55 ggeenneerraattee EEssccaappee,, aanndd mmaakkeess BBrreeaakk//RReesseett bbee aa sshhiifftt lloocckk.. <><> <> <> !! !! OOnn tthhee HHPP,, tthhee ffoolllloowwiinngg kkeeyyccooddeess hhaavvee kkeeyy ccaappss aass lliisstteedd:: !! !! 110011 BBaacckkssppaaccee !! 5555 CCaappss !! 1144 CCttrrll !! 1155 BBrreeaakk//RReesseett !! 8866 SSttoopp !! 8899 FF55 !! kkeeyyccooddee 110011 == DDeelleettee kkeeyyccooddee 5555 == CCoonnttrrooll__RR cclleeaarr LLoocckk aadddd CCoonnttrrooll == CCoonnttrrooll__RR kkeeyyccooddee 8899 == EEssccaappee kkeeyyccooddee 1155 == CCaappss__LLoocckk aadddd LLoocckk == CCaappss__LLoocckk <> <><> <> EENNVVIIRROONNMMEENNTT <> <> <> <> <>DDIISSPPLLAAYY<> <> ttoo ggeett ddeeffaauulltt hhoosstt aanndd ddiissppllaayy nnuummbbeerr.. <> <> SSEEEE AALLSSOO <> XX((77)),, xxeevv((11)),, _X_l_i_b ddooccuummeennttaattiioonn oonn kkeeyy aanndd ppooiinntteerr eevveennttss <> BBUUGGSS <> <> EEvveerryy ttiimmee aa kkeeyyccooddee eexxpprreessssiioonn iiss eevvaalluuaatteedd,, tthhee sseerrvveerr ggeenneerraatteess aa _M_a_p_p_i_n_g_N_o_t_i_f_y eevveenntt oonn eevveerryy cclliieenntt.. TThhiiss ccaann ccaauussee ssoommee tthhrraasshhiinngg.. AAllll ooff tthhee cchhaannggeess sshhoouulldd bbee bbaattcchheedd ttooggeetthheerr aanndd ddoonnee aatt oonnccee.. CClliieennttss tthhaatt rreecceeiivvee kkeeyybbooaarrdd iinnppuutt aanndd iiggnnoorree _M_a_p_p_i_n_g_N_o_t_i_f_y eevveennttss wwiillll nnoott nnoottiiccee aannyy cchhaannggeess mmaaddee ttoo kkeeyybbooaarrdd mmaappppiinnggss.. <> <>XXmmooddmmaapp<> sshhoouulldd ggeenneerraattee ""aadddd"" aanndd ""rreemmoovvee"" eexxpprreessssiioonnss aauuttoommaattiiccaallllyy wwhheenneevveerr aa kkeeyyccooddee tthhaatt iiss aallrreeaaddyy bboouunndd ttoo aa mmooddiiffiieerr iiss cchhaannggeedd.. <> TThheerree sshhoouulldd bbee aa wwaayy ttoo hhaavvee tthhee <>rreemmoovvee<> eexxpprreessssiioonn aacccceepptt kkeeyyccooddeess aass wweellll aass kkeeyyssyymmss ffoorr tthhoossee ttiimmeess wwhheenn yyoouu rreeaallllyy mmeessss uupp yyoouurr mmaappppiinnggss.. <> AAUUTTHHOORR <> JJiimm FFuullttoonn,, MMIITT XX CCoonnssoorrttiiuumm,, rreewwrriitttteenn ffrroomm aann eeaarrlliieerr vveerrssiioonn bbyy DDaavviidd RRoosseenntthhaall ooff SSuunn MMiiccrroossyysstteemmss.. <> <> <>