", Hyphenation = on, Consecutive Hyphens = 2, Vert. Just. = off> ", Level 1 Show = no, Level 2 Suffix = , Level 2 Starting Value = 0, Level 2 Show = no> ", Level 1 Show = no, Level 2 Suffix = "<#04>"> ", Level 1 Show = no, Level 2 Suffix = > ", Level 1 Show = no, Level 2 Suffix = "<#04>"> Control Functions ) (E10,0,0,0,1,1,0.053333,1,15,0,0,2,0,0,0,0,1,1,1,0.066667,0.066667,6,6,0,0.066 667,6))> Control Functions ) (E10,0,0,0,1,1,0.053333,1,15,0,0,2,0,0,0,0,1,1,1,0.066667,0.066667,6,6,0,0.066 667,6))> <|,"14<#1e>169"> CONTROL FUNCTIONS ) (E10,0,0,0,1,0,0.053333,1,15,0,0,1,0,0,0,0,1,0,1,0.066667,0.066667,6,6,0,0.066 667,6))> ) (T8,2,12,0.026667,0.733333,0,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,10 2,1101,3, <"table"> ) (T8,3,12,0.066667,0.6,0,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,102,110 1,3, ) (g9,5,0 (p7,5,8,19 (g9,5,0 (g9,5,0 (v4,5,0,0.266667,0,1.6,0,17,1,0) (v4,6,0,1.6,0,1.6,0.933333,17,1,0) (v4,7,0,1.6,0.933333,0.266667,0.933333,17,1,0) (v4,8,0,0.266667,0.933333,0.266667,0,17,1,0)))) (g9,10,8 (g9,10,1032 (p7,10,8,13 (g9,10,0 (g9,10,0 (v4,10,0,1.464913,0.934816,1.302281,0.934816,17,1,0) (v4,11,0,1.302281,0.934816,1.302281,0.784694,17,1,0) (v4,12,32,1.302281,0.784694,1.302281,0.653329,17,0,0) (v4,13,0,1.302281,0.653329,1.302281,0.353088,17,1,0) (v4,14,32,1.302281,0.353088,1.284211,0.14667,17,0,0) (v4,15,0,1.284211,0.14667,1.464913,0.14667,17,1,0) (v4,16,0,1.464913,0.14667,1.464913,0.653329,17,1,0) (v4,17,0,1.464913,0.653329,1.555264,0.653329,17,1,0) (v4,18,0,1.555264,0.653329,1.555264,0.784694,17,1,0) (v4,19,0,1.555264,0.784694,1.464913,0.784694,17,1,0) (v4,20,0,1.464913,0.784694,1.464913,0.934816,17,1,0)))) (p7,22,8,13 (g9,22,0 (g9,22,0 (v4,22,32,1.302281,0.784694,1.302281,0.653329,17,0,0) (v4,23,0,1.302281,0.653329,1.103508,0.653329,17,1,0) (v4,24,0,1.103508,0.653329,1.302281,0.353088,17,1,0) (v4,25,32,1.302281,0.353088,1.284211,0.14667,17,0,0) (v4,26,0,1.284211,0.14667,0.958948,0.615804,17,1,0) (v4,27,0,0.958948,0.615804,0.958948,0.784694,17,1,0) (v4,28,0,0.958948,0.784694,1.302281,0.784694,17,1,0))))) (g9,29,2048 (v4,29,33,0.940876,0.14667,0.940876,0.14667,17,0,0) (v4,30,33,0.940876,1.16,0.940876,1.16,17,0,0) (v4,31,33,1.573333,1.16,1.573333,1.16,17,0,0) (v4,32,33,1.573333,0.14667,1.573333,0.14667,17,0,0))) (g9,34,8 (p7,34,1032,13 (g9,34,0 (g9,34,0 (v4,34,0,0.874386,0.934816,0.874386,0.14667,17,1,0) (v4,35,0,0.874386,0.14667,0.729824,0.14667,17,1,0) (v4,36,0,0.729824,0.14667,0.585263,0.296792,17,1,0) (v4,37,0,0.585263,0.296792,0.585263,0.371851,17,1,0) (v4,38,0,0.585263,0.371851,0.711755,0.371851,17,1,0) (v4,39,0,0.711755,0.371851,0.711755,0.934816,17,1,0) (v4,40,0,0.711755,0.934816,0.874386,0.934816,17,1,0)))) (g9,41,2048 (v4,41,33,0.567192,0.14667,0.567192,0.14667,17,0,0) (v4,42,33,0.567192,1.16,0.567192,1.16,17,0,0) (v4,43,33,0.946667,1.16,0.946667,1.16,17,0,0) (v4,44,33,0.946667,0.14667,0.946667,0.14667,17,0,0)))) (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0,1,1,1,0.066667,0.066667,6,6,0,0.066 667,6))> Grabbing 14.1<#04>Certain cases may require that a client demand exclusive access to the the Serverserver,causing the processing for all other clients to be suspended. Such exclusiveaccess is referred to as grabbing the server. CLX provides functions to graband release exclusive access to the server. These function should be usedrarely and always with extreme caution, since they have the potential todisrupt the entire window system for all clients. grab<#1e>server displayFunctionserver", Sort String = "grab<#1e>server"> Disables processing of requests and close<#1e>downs on all connections other than the one on which this request arrived. display <#1f> A display. ungrab<#1e>server displayFunctionserver", Sort String = "ungrab<#1e>server"> Restarts processing of requests and close<#1e>downs on other connections. display <#1f> A display. with<#1e>server<#1e>grabbed display &body bodyMac roserver<#1e>grabbed", Sort String = "with<#1e>server<#1e>grabbed"> Grabs the display server only within the dynamic extent of the body. ungrab<#1e>server is automatically called upon exit from the body. This macro provides the most reliable way for CLX clients to grab the server. display <#1f> A display. body <#1f> The forms to execute while the server is grabbed. Pointer Control14.2<#04>The following paragraphs describe the CLX functions used to: wReturn or change the pointer acceleration and acceleration threshold wReturn or change the mapping of pointer button numbers change<#1e>pointer<#1e>control display &key :acceleration :thresholdFunctionpointer<#1e>control", Sort String = "change<#1e>pointer<#1e>control"> Changes the acceleration and/or the acceleration threshold of the pointer forthe display. The :acceleration number is used as a multiplier, typicallyspecified as a rational number of the form C/P, where C is the number of pixelpositions of cursor motion displayed for P units of pointer device motion. Theacceleration only occurs if the pointer moves more that :threshold pixels atonce, and only applies to the motion beyond the :threshold. Either:acceleration or :threshold can be set to :default, that restores the defaultsettings of the server. display <#1f> A display. :acceleration <#1f> A number for the acceleration ratio. :threshold <#1f> The number of pixels required for acceleration to take effect. <|,"14<#1e>170">pointer<#1e>control displayFunctioncontrol", Sort String = "pointer<#1e>control"> Returns:
acceleration, threshold <#1f> Type number. Returns the acceleration and threshold for the display pointer. display <#1f> A display. pointer<#1e>mapping display &key (:result<#1e>type 'list)Functionmapping", Sort String = "pointer<#1e>mapping"> Returns:
mapping <#1f> Type sequence or card8. Returns or (with setf) changes the mapping of button numbers for the displaypointer. The :result<#1e>type is not used when changing the mapping. If element i of the mapping sequence is j, then the events from pointer buttonj are reported by the server as events for button i+1. (Note that pointerbuttons are numbered beginning with one, while the mapping sequence itself isindexed normally from zero.) If element i of the mapping sequence iszero, then button i +1 is disabled and can no longer generate inputevents. No two elements of the mapping can have the same non<#1e>zero value. The length of the mapping sequence indicates the actual number of buttons onthe device. When changing the mapping, the new mapping must have this same length. display <#1f> A display. :result<#1e>type <#1f> The type of sequence to return. repeat", To Named = p1rule>repeat keys", To Named = p1rule> Keyboard 14.3<#04>The following paragraphs describe the CLX functions used to: Control wReturn or change keyboard controls wRing the keyboard bell wReturn or change the mapping of modifiers wReturn the current up/down state of all keys bell display &optional (percent<#1e>from<#1e>normal 0)Function Rings the bell on the keyboard at a volume relative to the base volume for the keyboard, if possible. Percent can range from -100 to 100 inclusive, or else a Value error occurs. The following is the bell volume when percent is non<#1e>negative: (- (+ base percent) (quotient (* base percent) 100)) and when percent is negative: (+ base (quotient (* base percent) 100)) display <#1f> A display. percent<#1e>from<#1e>normal <#1f> An integer (-100 through 100). <|,"14<#1e>171">change<#1e>keyboard<#1e>control display &key :key<#1e>clic k<#1e>percent :bell<#1e>percent Functionkeyboard<#1e>control", Sort String = "change<#1e>keyboard<#1e>control">
:bell<#1e>pitch :bell<#1e>duration :led :led<#1e>mode :key :auto<#1e>repea t<#1e>mode Changes the various aspects of the keyboard. The keyword arguments specify which controls to change. The :key<#1e>click<#1e>percent keyword sets the volume for key clicks, if possible. A value of 0 implies off, while a value of 100 implies loud. Setting :key<#1e>click<#1e>percent to :default restores the default value. The :bell<#1e>percent sets the base volume for the bell between 0 (off) and 100 (loud) if possible. Setting :bell<#1e>percent to :default restores the default value. The :bell<#1e>pitch sets the pitch (specified in Hz) of the bell, if possible. Setting the :bell<#1e>pitch to :default restores the default value. The :bell<#1e>duration sets the duration (specified in milliseconds) of the bell, if possible. Setting :bell<#1e>pitch to :default restores the default. Note that a bell generator connected with the console but not directly on the keyboard is treated as if it were part of the keyboard. If both :led<#1e>mode and :led are specified, then the state of that LED is changed, if possible. If only :led<#1e>mode is specified, the state of all LEDs are changed, if possible. At most 32 LEDs are supported, numbered from one. No standard interpretation of the LEDs are defined. If both :auto<#1e>repeat<#1e>mode and :key are specified, the auto<#1e>repeat mode of that key is changed, if possible. If only :auto<#1e>repeat<#1e>mode is specified, the global auto<#1e>repeat mode for the entire keyboard is changed, if possible, without affecting the per<#1e>key settings. An error occurs if :key is specified without :auto<#1e>repeat<#1e>mode. display <#1f> A display. :key<#1e>click<#1e>percent <#1f> An integer (0 100). :bell<#1e>percent <#1f> An integer (0 100). :bell<#1e>pitch <#1f> A card16. :bell<#1e>duration <#1f> A card16. :led <#1f> A card8. :led<#1e>mode <#1f> Either :on or :off. :key <#1f> A card8 keycode. :auto<#1e>repeat<#1e>mode <#1f> Either :on, :off, or :default. <|,"14<#1e>172">keyboard<#1e>control displayFunctioncontrol", Sort String = "keyboard<#1e>control"> Returns:
key<#1e>click<#1e>percent, bell<#1e>percent <#1f> Type card8 .
bell<#1e>pitch bell<#1e>duration <#1f> Type card16.
led<#1e>mask <#1f> Type card32.
global<#1e>auto<#1e>repeat <#1f> Either :on or :off .
auto<#1e>repeats <#1f> Type bit<#1e>vector. Returns the current control values for the keyboard. For the LEDs, the least significant bit of led<#1e>mask corresponds to LED one, and each one bit in led<#1e>mask indicates an LED that is lit. auto<#1e>repeats is a bit vector; each one bit indicates that auto<#1e>repeat is enabled for the corresponding key. The vector is represented as 32 bytes. Byte n (from 0) contains the bits for keys 8n to 8n+7, with the least significant bit in the byte representing key 8n. display <#1f> A display. modifier<#1e>mapping display Functionmapping", Sort String = "modifier<#1e>mapping"> Returns:
shift<#1e>keycodes, lock<#1e>keycodes, control<#1e>key codes, mod1<#1e>keycodes,mod2<#1e>keycodes , mod3<#1e>keycodes, mod4<#1e>keycodes, mod5<#1e> keycodes <#1f>
Type list of card8. Returns the set of keycodes used for each modifier on the display keyboard. Each return value is a list of the card8 keycodes used for each modifier key. The order of keycodes within each list is server<#1e>dependent. display <#1f> A display. query<#1e>keymap displayFunctionkeymap", Sort String = "query<#1e>keymap"> Returns:
keymap <#1f> Type bit<#1e>vector 256. Returns a bit vector that describes the state of the keyboard. Each one bit indicates that the corresponding key is currently pressed. The vector is represented as 32 bytes. Byte n (from 0) contains the bits for keys 8n to 8n+7, with the least significant bit in the byte representing key 8n. display <#1f> A display. set<#1e>modifier<#1e>mapping display &key :shift :lock :control :mod1 :mod2 Functionmodifier<#1e>mapping", Sort String = "set<#1e>modifier<#1e>mapping">
:mod3 :mod4 :mod5 Returns:
status <#1f> One of :success, :failed, or :device<#1e>busy. Changes the set of keycodes mapped to the specified modifier keys on thedisplay keyboard. Each keyword argument contains a sequence of newcard8 keycodes for a specific modifier. The return value indicateswhether the change was completed successfully. A status of :failed is returned if hardware limitations prevent therequested change. For example, multiple keycodes per modifier may not besupported, up transitions on a given keycode may not be supported, orautorepeat may be mandatory for a given keycode. If :failed is returned,the mappings for all modifiers remain unchanged. <|,"14<#1e>173">A status of :device<#1e>busy is returned if a new keycode given for amodifier was not previously mapped to that modifier and is currently inthe down state. In this case, the mappings for all modifiers remainunchanged. display <#1f> A display. :shift, :lock, :control, :mod1, :mod2 , :mod3, :mod4, :mod5 <#1f> A sequence of card8 keycodes for the given modifier. Keyboard 14.4<#04>Handling the great diversity of keyboard devices and international Encodingslanguagecharacter encodings is a difficult problem for interactive programs that needto receive text input but must also be portable. The X Window System solvesthis problem by using different sets of encodings for device keys (keycodes)an d for character symbols (keysyms). Each X server maintains a keyboardmapping that associates keycodes and keysyms, and which can be returned orchanged by client programs. To handle text input, a CLX client program must follow these steps: Receive a :key<#1e>press (or :key<#1e>release) event containing a keycode. Convert the keycode into its corresponding keysym, based on the currentkeyboard mapping. See keycode<#1e>keysym . Convert the keysym into the corresponding Common Lisp character. Seekeysym<#1e>character. Keycodes and14.4.1<#04> A keycode represents a physical (or logical) key. In CLX, keycodes Keysymsare values of type (integer 8 255). A keycode value carries no intrinsic information, although server implementors may attempt to encode geometry (for example, matrix) information in some fashion so it can be interpreted in a server<#1e> dependent fashion. The mapping between keys and keycodes cannot be changed. A keysym is an encoding of a symbol on the cap of a key. In CLX, keysyms are values of type card32. The set of defined keysyms include the ISO Latin character sets (1<#1e>4), Katakana, Arabic, Cyrillic, Greek, Technical, Special, Publishing, APL, Hebrew, and miscellaneous keys found on keyboards (RETURN, HELP, TAB, and so on). The encoding of keysyms is defined by the X Protocol. A list of keysyms is associated with each keycode. The length of the list can vary with each keycode. The list is intended to convey the set of symbols on the corresponding key. By convention, if the list contains a single keysym and if that keysym is alphabetic and case distinction is relevant, then it should be treated as equivalent to a two<#1e>element list of the lowercase and uppercase keysyms. For example, if the list contains the single keysym for uppercase A, the client should treat it as if it were a pair with lowercase as the first keysym and uppercase A as the second keysym. For any keycode, the first keysym in the list should be chosen as the interpretation of a key press when no modifier keys are down. The second keysym in the list normally should be chosen when the :shift modifier is on, or when the :lock modifier is on and :lock is interpreted as :shift<#1e>lock. When the :lock modifier is on and is interpreted as :caps<#1e>lock, it is suggested that the :shift modifier first be applied to choose a keysym, but if that keysym is lowercase alphabetic, the corresponding uppercase keysym should be used instead. <|,"14<#1e>174">Other interpretations of :caps<#1e>lock are possible; for example, it may be viewed as equivalent to :shift<#1e>lock, but only applying when the first keysym is lowercase alphabetic and the second keysym is the corresponding uppercase alphabetic. No interpretation of keysyms beyond the first two in a list is suggested here. No spatial geometry of the symbols on the key is defined by their order in the keysym list, although a geometry might be defined on a vendor<#1e>specific basis. The X server does not use the mapping between keycodes and keysyms. Rather, the X server stores the mapping merely for reading and writing by clients. Keyboard14.4.2<#04>The X server maintains a keyboard mapping that associates each Mappingkeycode withone or more keysyms. The following paragraphs describe the CLX functions used to returnor change the mapping of keycodes. change<#1e>keyboard<#1e>mapping display keysyms &key (:start 0) :end Functionkeyboard<#1e>mapping", Sort String = "change<#1e>keyboard<#1e>mapping">
(:first<#1e>keycode :start) Changes the mapping of keycodes to keysyms. A :mapping<#1e>notif y event isgenerated for all clients. The new keysyms are specified as a two<#1e>dimensional array in which: (arefkeysyms (+ :start i) j ) is keysym j associated with keycode (+:first<#1e>k eycode i). The maximum number of keysyms associated with anyone keycode is given by: (array<#1e>dimension keysyms 1) keysyms shouldcontain nil elements to represent those keysyms that are undefined fora given keycode. :start and :end define the subsequence of the keysyms array thatdefines the new mapping, and the number of keycode mappings changed. Bydefault, :end is given by: (array<#1e>dimension keysyms 0) The keycodeswhose mappings are changed are given by :first<#1e>keycode through the following: (+:first<#1e>keycode (- :end :start) -1) keycodes outside this range of arenot affected. :first<#1e>keycode must not be less than (display<#1e>min<#1e>keycodedisp lay), and the last keycode modified must not be greater than(disp lay<#1e>max<#1e>keycode display). display <#1f> A display. keysyms <#1f> A two<#1e>dimensional array of keysym (card32) values. :start, :end <#1f> Indexes for the subsequence of keysyms used. :first<#1e>keycode <#1f> A card8 defining the first keycode mapping changed. <|,"14<#1e>175">keyboard<#1e>mapping display &key :first<#1e>keycode :start :end :dataFunctionmapping", Sort String = "keyboard<#1e>mapping"> Returns:
mappings <#1f> Type (array card32 (* *)). Returns the keysyms mapped to the given range of keycodes for thedispl ay keyboard. The mappings are returned in the form of atwo<#1e>dimensi onal array of card32 keysym values. The :data argument, ifgiven, must be a two<#1e>dimensional array in which the returned mappingswill be stored. In this case: (array<#1e>dimension :data 1) defines themaximum number of keysyms returned for any keycode. Otherwise, a newarray is created and returned. Upon return: (aref mappings (+ :start i)j ) will contain keysym j associated with keycode (+:first<#1e>k eycode i) (or nil, if keysymj is undefined for thatkeycode). :first<#1e>keycode specifies the first keycode whose mapping is returned; bydefault, :first<#1e>keycode is (display<#1e>m in<#1e>keycode display).:start and :end define the subsequence of the returned array in whichthe returned mappings are stored. By default, :start is given by:first<#1e> keycode and :end is given by: (1+ (display<#1e>max<#1e>keycode display)) :first<#1e>keycode must not be less than (display<#1e>min<#1e>ke ycode display), and the last keycode returned must not be greater than (display<#1e>max<#1e>ke ycodedisplay). display <#1f> A display. :first<#1e>keycode <#1f> A card8 defining the first keycode mapping returned. :start, :end <#1f> Indexes for the subsequence of the returned array which is modified. :data <#1f> If given, a two<#1e>dimensional array to receive the returned keysyms. Using Keycodes14.4.3 <#04>The following paragraphs describe the CLX functions used to: and Keysyms wConvert a keycode into a keysym wConvert a keysym into a character keycode<#1e>keysym display keycode keysym<#1e>index Functio nkeysym", Sort String = "keycode<#1e>keysym"> Returns:
keysym <#1f> Type keysym. Returns the keysym at the given keysym<#1e>index from the keysym list for thekeycode in the current keyboard mapping for the display server. display <#1f> A display. keycode <#1f> A card8. keysym<#1e>index <#1f> A card8. <|,"14<#1e>176">keycode<#1e>character display keysym &optional (state 0)Functioncharacter", Sort String = "keycode<#1e>character"> Returns:
character <#1f> Type character or null. Returns the character associated with the keysym and the state. The stateis a mask16 bit mask representing the state of the display modifier keysand pointer buttons. See state<#1e>mask<#1e>key in paragraph 1.6, Data Types. If thekeysym does not represent a Common Lisp character, then nil is returned. The state determines the bits attribute of the returned characte r, asfollows: :controlchar<#1e>control<#1e>bit
:mod<#1e>1char<#1e>meta<#1e>bit
:mod<#1e>2char<#1e>super<#1e>bit
:mod<#1e>3char<#1e>hyper<#1e>bit display <#1f> A display. keysym <#1f> A keysym. state <#1f> A mask16. Client 14.5<#04>The CLX functions affecting client termination are discussed in the Terminationfollowing paragraphs. When a display connection to an X server is closed, whether by an explicitcall to close<#1e>display or by some external condition, the serverautomatically performs a sequence of operations to clean up server stateinformation associated with the closed connection. The effect of theseoperations depends the close<#1e>down mode and the save<#1e>set thatthe client has specified for the closed display connection. The close<#1e>downmode of a display determines whether server resources allocated by theconnection are freed or not. The save<#1e>set identifies windows that willremain after the connection is closed. The display save<#1e>set is used primarily by window managers that reparent thetop<#1e>level windows of other clients. For example, such a window manager canautomatically create a frame window that encloses a top<#1e>level clientwindow, along with a set of controls used for window management.Ordinarily, termination of the window manager client would then destroy allclient windows! However, the window manager can prevent this by adding toits save<#1e>set those windows created by other clients that should bepreserved. When a display connection closes, an X server performs the followingoperati ons: For each selection owned by a window created on the connection, the selection owner is set to nil. An active or passive grab established for a window created on the connection is released. If the connection has grabbed the server, the server is ungrabbed. <|,"14<#1e>177">Server resources and colormap cells allocated by the connection are freed and destroyed, depending on the close<#1e>down mode, as follows: :retain<#1e>permanent <#1f> All resources are marked permanent , and no resources are destroyed. These resources can later be destroyed by a call to kill<#1e>client. :retain<#1e>temporary <#1f> All resources are marked temporary , and no resources are destroyed. These resources can later be destroyed by a call to kill<#1e>client or kill<#1e>temporary<#1e> clients. :destroy <#1f> All resources are destroyed. When server resources allocated by a display connection are destroyed <#1f>whether by closing the connection with close<#1e>down mode :destr oy or by latercalling kill<#1e>client or kill<#1e>tempo rary<#1e>clients <#1f> then an X server performsthe following operations on each member of the save<#1e>set before actuallydestroying resources. If the save<#1e>set window is a descendant of a window created on the connection, the save<#1e>set window is reparented. The new parent is the closest ancestor such that the save<#1e>set window is no longer a descendant of any window created on the connection. The position of the reparented window with respect to its parent remains unchanged. If the save<#1e>set window is unmapped, then it is mapped. If the last connection open to an X server is closed with close<#1e>down mode:destroy, the server resets its state to restore all initial defaults.The server state after reset is the same as its initial state when firststarted. When an X server resets, it performs the following operations: wAll permanent and temporary server resources from previously<#1e>closed connections are destroyed. wAll but the predefined atoms are deleted. wAll root window properties are deleted. wAll device control attributes and mappings are restored to their original default values. wThe default background and cursor for all root windows are restored. wThe default font path is restored. wThe input focus is set to :pointer<#1e>root. wThe access control list is reset. The following paragraphs describe the CLX functions used to: wAdd or remove a window from a display save<#1e>set. wReturn or change the display close<#1e>down mode. wForce a connection to be closed or all its server resources to be destroyed. wForce a connection to be closed and all temporary resources to be destroyed. <|,"14<#1e>178">add<#1e>to<#1e>save<#1e>set windowFunctionto<#1e>save<#1e>set", Sort String = "add<#1e>to<#1e>save<#1e>set"> Adds the specified window to the save<#1e>set of the window display. The window must have been created by some other display. Windows are removed automatically from the save<#1e>set when they are destroyed. window <#1f> A window. close<#1e>down<#1e>mode displayFunctiondown<#1e>mode", Sort String = "close<#1e>down<#1e>mode"> Returns:
mode <#1f> One of :destroy, :retain<#1e>permanent, or :retain<#1e>temporary. Returns and (with setf) sets the close<#1e>down mode of the client's resources at connection close. display <#1f> A display. kill<#1e>client display resource<#1e>idFunctionclient", Sort String = "kill<#1e>client"> Closes the display connection which created the given resource<#1e>id . Theresource<#1e>id must be valid, but need not belong to the given display. If the closed connection was previously open, the connection is closedaccor ding to its close<#1e>down mode. Otherwise, if the connection had beenpreviously terminated with close<#1e>down mode :retain<#1e>permane nt or:retain<#1e>temporary, then all its retained server resources <#1f> both permanentand temporary <#1f> are destroyed. display <#1f> A display. resource<#1e>id <#1f> A valid card29 resource ID. kill<#1e>temporary<#1e>clients displayFunctiontemporary<#1e>clients", Sort String = "kill<#1e>temporary<#1e>clients"> Closes the display connection and destroys all retained temporary serverresources for this and all previously<#1e>terminated connections. If the display connection was previously open, the connection is closedaccording to its close<#1e>down mode. Otherwise, if the displ ay connection hadbeen previously terminated with close<#1e>down mode :retain<#1e>permanent or:retain<#1e>temporary, then all its retained server resources <#1f> both permanentand temporary <#1f> are destroyed. display <#1f> A display. remove<#1e>from<#1e>save<#1e>set windowFunctionfrom<#1e>save<#1e>set ", Sort String = "remove<#1e>from<#1e>save<#1e>set "> Removes the specified window from the save<#1e>set of the window display. The window must have been created by some other display. Windows are removed automatically from the save<#1e>set when they are destroyed. window <#1f> A window. <|,"14<#1e>179"> Managing Host 14.6<#04>An X server maintains a list of hosts from which client programs can be Accessrun. Only clients executing on hosts that belong to this access control list are allowed to open a connection to the server. Typically, the access control list can be changed by clients running on the same host as the server. Some server implementations can also implement other authorization mechanisms in addition to, or in place of, this mechanism. The action of this mechanism can be conditional based on the authorization protocol name and data received by the server at connection setup. The following paragraphs describe the CLX functions used to: wAdd or remove hosts on the access control list. wReturn the hosts on the access control list. wReturn or change the state of the access control list mechanism access<#1e>control displayFunctioncontrol", Sort String = "access<#1e>control"> Returns:
enabled<#1e>p <#1f> Type boolean. Returns and (with setf) changes the state of the access control listmechanism for the display server. Returns true if access control isenabled; otherwise, nil is returned. If enabled, the access control listis used to validate each client during connection setup. Only a client running on the same host as the server is allowed toenable or disable the access control list mechanism. display <#1f> A display. access<#1e>hostsdisplay &key (:result<#1e>type 'l ist)Functionhosts", Sort String = "access<#1e>hosts"> Returns:
hosts <#1f> sequence of string.
enabled<#1e>p <#1f> Type boolean. Returns a sequence containing the hosts that belong to the accesscontrol list of the display server. Elements of the returned hostssequence are either strings or some other type of object recognized as ahost name by add<#1e>access<#1e>ho st and remove<#1e>access<#1e>host. The second returnedvalue specifies whether the access control list mechanism is currentlyenabled or disabled (see access<#1e>control). display <#1f> A display. :result<#1e>type <#1f> The type of hosts sequence to return. add<#1e>access<#1e>host display hostFunctionaccess<#1e>host", Sort String = "add<#1e>access<#1e>host"> Adds the specified host to the access control list. Only a client running on the same host as the server can change the access control list. display <#1f> A display. host <#1f> A host name. Either a string or some other implementation<#1e>d ependent type. <|,"14<#1e>180">remove<#1e>access<#1e>host display hostFunctionaccess<#1e>host", Sort String = "remove<#1e>access<#1e>host"> Removes the specified host from the access control list. Only a client running on the same host as the server can change the access control list. display <#1f> A display. host <#1f> A host name. Either a string or some other implementation<#1e>d ependent type. Screen Saver14.7<#04>To prevent monitor damage, an X server implements a screen saver function which blanks screens during periods of unuse. The screen saver can be in one of three states: wDisabled <#1f> No screen blanking is done and screen content remains unchanged. wDeactivated <#1f> The server is being used. When the server input devices are unused for a specific amount of time, the screen saver becomes activated. wActivated <#1f> The server input devices are unused. The screen saver blanks all server screens or displays a server<#1e>dependent image. As soon as an input event from either the pointer or the keyboard occurs, the screen saver is deactivated and its timer is reset. The following paragraphs describe the CLX functions used to: wReturn or change screen saver control values. wActivate or reset the screen saver activate<#1e>screen<#1e>saver displayFunctionscreen<#1e>saver", Sort String = "activate<#1e>screen<#1e>saver"> Activates the screen saver for the display server. display <#1f> A display. reset<#1e>screen<#1e>saver displayFunctionscreen<#1e>saver", Sort String = "reset<#1e>screen<#1e>saver"> Deactivates the screen saver for the display server (if necessary) and resets its timer, just as if a pointer or keyboard event had occurred. display <#1f> A display. screen<#1e>saverdisplayFunctionsaver", Sort String = "screen<#1e>saver"> Returns:
timeout, period <#1f> Type int16.
blanking, exposures <#1f> One of :yes or :no. Returns the current control values for the display server screen saver. See set<#1e>screen<#1e>saver. display <#1f> A display. <|,"14<#1e>181">set<#1e>screen<#1e>saver display timeout period blanking exposures Functionscreen<#1e>saver", Sort String = "set<#1e>screen<#1e>saver"> Changes the current control values for the display server screen saver.The screen saver is reset. The screen saver is also disabled if: wtimeout is zero, or wBoth blanking and exposures are disabled and the server cannot regenerate the screen contents without sending :exposure events. The timeout specifies the (non<#1e>negative) number of seconds of inputdevice inactivity that must elapse before the screen saver is activated.The timeout can be set to :default to restore the server default timeoutinterval. If blanking is :yes and the screen hardware supports blanking, blanking is enabled; that is, the screen saver will simply blank allscreens when it is activated. blanking can be set to :default torestore the server default state for blanking. If exposures is :yes, exposures are enabled. If exposures areenabled, or if the server is capable of regenerating screen contentswithout sending :exposure events, the screen saver will displaysome server<#1e>dependent image when activated. Frequently, this image willconsist of a repeating animation sequence, in which case periodspecifies the (non<#1e>negative) number of seconds for each repetition. Aperiod of zero is a hint that no repetition should occur. display <#1f> A display. timeout <#1f> Specifies the delay until timeout takes over. period <#1f> Specifies the periodic change interval, if used. blanking <#1f> Specifies whether the blanking option is available. exposures <#1f> Specifies whether exposures are allowed during blanking. <|,"14<#1e>182"> .