DataMuseum.dk

top - download

    Length: 6072 (0x17b8)
    Names: »XSetErrorHandler.3X«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./usr/man/cat3/XSetErrorHandler.3X« 

Default Hex Dump

0x0000…0020 0a 0a 0a 5f 08 4f 5f 08 6e 5f 08 6c 5f 08 69 5f 08 6e 5f 08 65 20 5f 08 4d 5f 08 61 5f 08 6e 5f   ┆   _ O_ n_ l_ i_ n_ e _ M_ a_ n_┆
0x0020…0040 08 75 5f 08 61 5f 08 6c 20 20 20 20 20 20 20 20 20 20 20 4c 69 62 72 61 72 79 20 46 75 6e 63 74   ┆ u_ a_ l           Library Funct┆
0x0040…0060 69 6f 6e 73 20 20 20 20 58 53 65 74 45 72 72 6f 72 48 61 6e 64 6c 65 72 28 33 58 29 0a 0a 0a 0a   ┆ions    XSetErrorHandler(3X)    ┆
0x0060…0080 4e 08 4e 08 4e 08 4e 41 08 41 08 41 08 41 4d 08 4d 08 4d 08 4d 45 08 45 08 45 08 45 0a 20 20 20   ┆N N N NA A A AM M M ME E E E    ┆
0x0080…00a0 20 20 58 53 65 74 45 72 72 6f 72 48 61 6e 64 6c 65 72 2c 20 58 47 65 74 45 72 72 6f 72 54 65 78   ┆  XSetErrorHandler, XGetErrorTex┆
0x00a0…00c0 74 2c 20 58 44 69 73 70 6c 61 79 4e 61 6d 65 2c 20 58 53 65 74 49 4f 45 72 2d 0a 20 20 20 20 20   ┆t, XDisplayName, XSetIOEr-      ┆
0x00c0…00e0 72 6f 72 48 61 6e 64 6c 65 72 2c 20 58 47 65 74 45 72 72 6f 72 44 61 74 61 62 61 73 65 54 65 78   ┆rorHandler, XGetErrorDatabaseTex┆
0x00e0…0100 74 20 2d 20 64 65 66 61 75 6c 74 20 65 72 72 6f 72 20 68 61 6e 64 6c 65 72 73 0a 0a 53 08 53 08   ┆t - default error handlers  S S ┆
0x0100…0120 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08 4e 08 4e 54 08 54 08 54 08 54 41 08 41 08 41 08 41 58   ┆S SY Y Y YN N N NT T T TA A A AX┆
0x0120…0140 08 58 08 58 08 58 0a 20 20 20 20 20 69 6e 74 20 28 2a 58 53 65 74 45 72 72 6f 72 48 61 6e 64 6c   ┆ X X X      int (*XSetErrorHandl┆
0x0140…0160 65 72 28 5f 08 68 5f 08 61 5f 08 6e 5f 08 64 5f 08 6c 5f 08 65 5f 08 72 29 29 28 29 0a 20 20 20   ┆er(_ h_ a_ n_ d_ l_ e_ r))()    ┆
0x0160…0180 20 20 20 20 20 20 20 20 69 6e 74 20 28 2a 5f 08 68 5f 08 61 5f 08 6e 5f 08 64 5f 08 6c 5f 08 65   ┆        int (*_ h_ a_ n_ d_ l_ e┆
0x0180…01a0 5f 08 72 29 28 44 69 73 70 6c 61 79 20 2a 2c 20 58 45 72 72 6f 72 45 76 65 6e 74 20 2a 29 0a 0a   ┆_ r)(Display *, XErrorEvent *)  ┆
0x01a0…01c0 20 20 20 20 20 58 47 65 74 45 72 72 6f 72 54 65 78 74 28 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f   ┆     XGetErrorText(_ d_ i_ s_ p_┆
0x01c0…01e0 08 6c 5f 08 61 5f 08 79 2c 20 5f 08 63 5f 08 6f 5f 08 64 5f 08 65 2c 20 5f 08 62 5f 08 75 5f 08   ┆ l_ a_ y, _ c_ o_ d_ e, _ b_ u_ ┆
0x01e0…0200 66 5f 08 66 5f 08 65 5f 08 72 5f 5f 08 72 5f 08 65 5f 08 74 5f 08 75 5f 08 72 5f 08 6e 2c 20 5f   ┆f_ f_ e_ r__ r_ e_ t_ u_ r_ n, _┆
0x0200…0220 08 6c 5f 08 65 5f 08 6e 5f 08 67 5f 08 74 5f 08 68 29 0a 20 20 20 20 20 20 20 20 20 20 20 44 69   ┆ l_ e_ n_ g_ t_ h)            Di┆
0x0220…0240 73 70 6c 61 79 20 2a 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 3b 0a 20 20   ┆splay *_ d_ i_ s_ p_ l_ a_ y;   ┆
0x0240…0260 20 20 20 20 20 20 20 20 20 69 6e 74 20 5f 08 63 5f 08 6f 5f 08 64 5f 08 65 3b 0a 20 20 20 20 20   ┆         int _ c_ o_ d_ e;      ┆
0x0260…0280 20 20 20 20 20 20 63 68 61 72 20 2a 5f 08 62 5f 08 75 5f 08 66 5f 08 66 5f 08 65 5f 08 72 5f 5f   ┆      char *_ b_ u_ f_ f_ e_ r__┆
0x0280…02a0 08 72 5f 08 65 5f 08 74 5f 08 75 5f 08 72 5f 08 6e 3b 0a 20 20 20 20 20 20 20 20 20 20 20 69 6e   ┆ r_ e_ t_ u_ r_ n;            in┆
0x02a0…02c0 74 20 5f 08 6c 5f 08 65 5f 08 6e 5f 08 67 5f 08 74 5f 08 68 3b 0a 0a 20 20 20 20 20 63 68 61 72   ┆t _ l_ e_ n_ g_ t_ h;       char┆
0x02c0…02e0 20 2a 58 44 69 73 70 6c 61 79 4e 61 6d 65 28 5f 08 73 5f 08 74 5f 08 72 5f 08 69 5f 08 6e 5f 08   ┆ *XDisplayName(_ s_ t_ r_ i_ n_ ┆
0x02e0…0300 67 29 0a 20 20 20 20 20 20 20 20 20 20 20 63 68 61 72 20 2a 5f 08 73 5f 08 74 5f 08 72 5f 08 69   ┆g)            char *_ s_ t_ r_ i┆
0x0300…0320 5f 08 6e 5f 08 67 3b 0a 0a 20 20 20 20 20 69 6e 74 20 28 2a 58 53 65 74 49 4f 45 72 72 6f 72 48   ┆_ n_ g;       int (*XSetIOErrorH┆
0x0320…0340 61 6e 64 6c 65 72 28 5f 08 68 5f 08 61 5f 08 6e 5f 08 64 5f 08 6c 5f 08 65 5f 08 72 29 29 28 29   ┆andler(_ h_ a_ n_ d_ l_ e_ r))()┆
0x0340…0360 0a 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 28 2a 5f 08 68 5f 08 61 5f 08 6e 5f 08 64 5f 08   ┆            int (*_ h_ a_ n_ d_ ┆
0x0360…0380 6c 5f 08 65 5f 08 72 29 28 44 69 73 70 6c 61 79 20 2a 29 3b 0a 0a 20 20 20 20 20 58 47 65 74 45   ┆l_ e_ r)(Display *);       XGetE┆
0x0380…03a0 72 72 6f 72 44 61 74 61 62 61 73 65 54 65 78 74 28 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c   ┆rrorDatabaseText(_ d_ i_ s_ p_ l┆
0x03a0…03c0 5f 08 61 5f 08 79 2c 20 5f 08 6e 5f 08 61 5f 08 6d 5f 08 65 2c 20 5f 08 6d 5f 08 65 5f 08 73 5f   ┆_ a_ y, _ n_ a_ m_ e, _ m_ e_ s_┆
0x03c0…03e0 08 73 5f 08 61 5f 08 67 5f 08 65 2c 0a 20 20 20 20 20 5f 08 64 5f 08 65 5f 08 66 5f 08 61 5f 08   ┆ s_ a_ g_ e,      _ d_ e_ f_ a_ ┆
0x03e0…0400 75 5f 08 6c 5f 08 74 5f 5f 08 73 5f 08 74 5f 08 72 5f 08 69 5f 08 6e 5f 08 67 2c 20 5f 08 62 5f   ┆u_ l_ t__ s_ t_ r_ i_ n_ g, _ b_┆
0x0400…0420 08 75 5f 08 66 5f 08 66 5f 08 65 5f 08 72 5f 5f 08 72 5f 08 65 5f 08 74 5f 08 75 5f 08 72 5f 08   ┆ u_ f_ f_ e_ r__ r_ e_ t_ u_ r_ ┆
0x0420…0440 6e 2c 20 5f 08 6c 5f 08 65 5f 08 6e 5f 08 67 5f 08 74 5f 08 68 29 0a 20 20 20 20 20 20 20 20 20   ┆n, _ l_ e_ n_ g_ t_ h)          ┆
0x0440…0460 20 20 44 69 73 70 6c 61 79 20 2a 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79   ┆  Display *_ d_ i_ s_ p_ l_ a_ y┆
0x0460…0480 3b 0a 20 20 20 20 20 20 20 20 20 20 20 63 68 61 72 20 2a 5f 08 6e 5f 08 61 5f 08 6d 5f 08 65 2c   ┆;            char *_ n_ a_ m_ e,┆
0x0480…04a0 20 2a 5f 08 6d 5f 08 65 5f 08 73 5f 08 73 5f 08 61 5f 08 67 5f 08 65 3b 0a 20 20 20 20 20 20 20   ┆ *_ m_ e_ s_ s_ a_ g_ e;        ┆
0x04a0…04c0 20 20 20 20 63 68 61 72 20 2a 5f 08 64 5f 08 65 5f 08 66 5f 08 61 5f 08 75 5f 08 6c 5f 08 74 5f   ┆    char *_ d_ e_ f_ a_ u_ l_ t_┆
0x04c0…04e0 5f 08 73 5f 08 74 5f 08 72 5f 08 69 5f 08 6e 5f 08 67 3b 0a 20 20 20 20 20 20 20 20 20 20 20 63   ┆_ s_ t_ r_ i_ n_ g;            c┆
0x04e0…0500 68 61 72 20 2a 5f 08 62 5f 08 75 5f 08 66 5f 08 66 5f 08 65 5f 08 72 5f 5f 08 72 5f 08 65 5f 08   ┆har *_ b_ u_ f_ f_ e_ r__ r_ e_ ┆
0x0500…0520 74 5f 08 75 5f 08 72 5f 08 6e 3b 0a 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 5f 08 6c 5f 08   ┆t_ u_ r_ n;            int _ l_ ┆
0x0520…0540 65 5f 08 6e 5f 08 67 5f 08 74 5f 08 68 3b 0a 0a 41 08 41 08 41 08 41 52 08 52 08 52 08 52 47 08   ┆e_ n_ g_ t_ h;  A A A AR R R RG ┆
0x0540…0560 47 08 47 08 47 55 08 55 08 55 08 55 4d 08 4d 08 4d 08 4d 45 08 45 08 45 08 45 4e 08 4e 08 4e 08   ┆G G GU U U UM M M ME E E EN N N ┆
0x0560…0580 4e 54 08 54 08 54 08 54 53 08 53 08 53 08 53 0a 20 20 20 20 20 5f 08 62 5f 08 75 5f 08 66 5f 08   ┆NT T T TS S S S      _ b_ u_ f_ ┆
0x0580…05a0 66 5f 08 65 5f 08 72 5f 5f 08 72 5f 08 65 5f 08 74 5f 08 75 5f 08 72 5f 08 6e 0a 20 20 20 20 20   ┆f_ e_ r__ r_ e_ t_ u_ r_ n      ┆
0x05a0…05c0 20 20 20 20 20 20 20 20 20 20 52 65 74 75 72 6e 73 20 74 68 65 20 65 72 72 6f 72 20 64 65 73 63   ┆          Returns the error desc┆
0x05c0…05e0 72 69 70 74 69 6f 6e 2e 0a 0a 20 20 20 20 20 5f 08 63 5f 08 6f 5f 08 64 5f 08 65 20 20 20 20 20   ┆ription.       _ c_ o_ d_ e     ┆
0x05e0…0600 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 66 6f 72 20 77 68   ┆ Specifies the error code for wh┆
0x0600…0620 69 63 68 20 79 6f 75 20 77 61 6e 74 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f   ┆ich you want to                o┆
0x0620…0640 62 74 61 69 6e 20 61 20 64 65 73 63 72 69 70 74 69 6f 6e 2e 0a 0a 20 20 20 20 20 5f 08 64 5f 08   ┆btain a description.       _ d_ ┆
0x0640…0660 65 5f 08 66 5f 08 61 5f 08 75 5f 08 6c 5f 08 74 5f 5f 08 73 5f 08 74 5f 08 72 5f 08 69 5f 08 6e   ┆e_ f_ a_ u_ l_ t__ s_ t_ r_ i_ n┆
0x0660…0680 5f 08 67 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65   ┆_ g                Specifies the┆
0x0680…06a0 20 64 65 66 61 75 6c 74 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69 66 20 6e 6f 6e 65 20 69   ┆ default error message if none i┆
0x06a0…06c0 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 64 61   ┆s                found in the da┆
0x06c0…06e0 74 61 62 61 73 65 2e 0a 0a 20 20 20 20 20 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61   ┆tabase.       _ d_ i_ s_ p_ l_ a┆
0x06e0…0700 5f 08 79 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74   ┆_ y   Specifies the connection t┆
0x0700…0720 6f 20 74 68 65 20 58 20 73 65 72 76 65 72 2e 0a 0a 20 20 20 20 20 5f 08 68 5f 08 61 5f 08 6e 5f   ┆o the X server.       _ h_ a_ n_┆
0x0720…0740 08 64 5f 08 6c 5f 08 65 5f 08 72 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 70 72 6f 67   ┆ d_ l_ e_ r   Specifies the prog┆
0x0740…0760 72 61 6d 27 73 20 73 75 70 70 6c 69 65 64 20 65 72 72 6f 72 20 68 61 6e 64 6c 65 72 2e 0a 0a 20   ┆ram's supplied error handler.   ┆
0x0760…0780 20 20 20 20 5f 08 6c 5f 08 65 5f 08 6e 5f 08 67 5f 08 74 5f 08 68 20 20 20 20 53 70 65 63 69 66   ┆    _ l_ e_ n_ g_ t_ h    Specif┆
0x0780…07a0 69 65 73 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 62 75 66 66 65 72 2e 0a 0a 20 20 20   ┆ies the size of the buffer.     ┆
0x07a0…07c0 20 20 5f 08 6d 5f 08 65 5f 08 73 5f 08 73 5f 08 61 5f 08 67 5f 08 65 20 20 20 53 70 65 63 69 66   ┆  _ m_ e_ s_ s_ a_ g_ e   Specif┆
0x07c0…07e0 69 65 73 20 74 68 65 20 74 79 70 65 20 6f 66 20 74 68 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67   ┆ies the type of the error messag┆
0x07e0…0800 65 2e 0a 0a 20 20 20 20 20 5f 08 6e 5f 08 61 5f 08 6d 5f 08 65 20 20 20 20 20 20 53 70 65 63 69   ┆e.       _ n_ a_ m_ e      Speci┆
0x0800…0820 66 69 65 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e   ┆fies the name of the application┆
0x0820…0840 2e 0a 0a 20 20 20 20 20 5f 08 73 5f 08 74 5f 08 72 5f 08 69 5f 08 6e 5f 08 67 20 20 20 20 53 70   ┆.       _ s_ t_ r_ i_ n_ g    Sp┆
0x0840…0860 65 63 69 66 69 65 73 20 74 68 65 20 63 68 61 72 61 63 74 65 72 20 73 74 72 69 6e 67 2e 0a 0a 44   ┆ecifies the character string.  D┆
0x0860…0880 08 44 08 44 08 44 45 08 45 08 45 08 45 53 08 53 08 53 08 53 43 08 43 08 43 08 43 52 08 52 08 52   ┆ D D DE E E ES S S SC C C CR R R┆
0x0880…08a0 08 52 49 08 49 08 49 08 49 50 08 50 08 50 08 50 54 08 54 08 54 08 54 49 08 49 08 49 08 49 4f 08   ┆ RI I I IP P P PT T T TI I I IO ┆
0x08a0…08c0 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 58 6c 69 62 20 67 65 6e 65 72 61 6c 6c 79   ┆O O ON N N N      Xlib generally┆
0x08c0…08e0 20 63 61 6c 6c 73 20 74 68 65 20 70 72 6f 67 72 61 6d 27 73 20 73 75 70 70 6c 69 65 64 20 65 72   ┆ calls the program's supplied er┆
0x08e0…0900 72 6f 72 20 68 61 6e 64 6c 65 72 0a 20 20 20 20 20 77 68 65 6e 65 76 65 72 20 61 6e 20 65 72 72   ┆ror handler      whenever an err┆
0x0900…0920 6f 72 20 69 73 20 72 65 63 65 69 76 65 64 2e 20 20 49 74 20 69 73 20 6e 6f 74 20 63 61 6c 6c 65   ┆or is received.  It is not calle┆
0x0920…0940 64 20 6f 6e 20 5f 08 42 5f 08 61 5f 08 64 5f 08 4e 5f 08 61 5f 08 6d 5f 08 65 0a 20 20 20 20 20   ┆d on _ B_ a_ d_ N_ a_ m_ e      ┆
0x0940…0960 65 72 72 6f 72 73 20 66 72 6f 6d 20 5f 08 4f 5f 08 70 5f 08 65 5f 08 6e 5f 08 46 5f 08 6f 5f 08   ┆errors from _ O_ p_ e_ n_ F_ o_ ┆
0x0960…0980 6e 5f 08 74 2c 20 5f 08 4c 5f 08 6f 5f 08 6f 5f 08 6b 5f 08 75 5f 08 70 5f 08 43 5f 08 6f 5f 08   ┆n_ t, _ L_ o_ o_ k_ u_ p_ C_ o_ ┆
0x0980…09a0 6c 5f 08 6f 5f 08 72 2c 20 6f 72 20 5f 08 41 5f 08 6c 5f 08 6c 5f 08 6f 5f 08 63 5f 08 4e 5f 08   ┆l_ o_ r, or _ A_ l_ l_ o_ c_ N_ ┆
0x09a0…09c0 61 5f 08 6d 5f 08 65 5f 08 64 5f 08 43 5f 08 6f 5f 08 6c 5f 08 6f 5f 08 72 20 70 72 6f 74 6f 2d   ┆a_ m_ e_ d_ C_ o_ l_ o_ r proto-┆
0x09c0…09e0 0a 20 20 20 20 20 63 6f 6c 20 72 65 71 75 65 73 74 73 20 6f 72 20 6f 6e 20 5f 08 42 5f 08 61 5f   ┆      col requests or on _ B_ a_┆
0x09e0…0a00 08 64 5f 08 46 5f 08 6f 5f 08 6e 5f 08 74 20 65 72 72 6f 72 73 20 66 72 6f 6d 20 61 20 5f 08 51   ┆ d_ F_ o_ n_ t errors from a _ Q┆
0x0a00…0a20 5f 08 75 5f 08 65 5f 08 72 5f 08 79 5f 08 46 5f 08 6f 5f 08 6e 5f 08 74 20 70 72 6f 74 6f 63 6f   ┆_ u_ e_ r_ y_ F_ o_ n_ t protoco┆
0x0a20…0a40 6c 0a 20 20 20 20 20 72 65 71 75 65 73 74 2e 20 20 54 68 65 73 65 20 65 72 72 6f 72 73 20 67 65   ┆l      request.  These errors ge┆
0x0a40…0a60 6e 65 72 61 6c 6c 79 20 61 72 65 20 72 65 66 6c 65 63 74 65 64 20 62 61 63 6b 20 74 6f 20 74 68   ┆nerally are reflected back to th┆
0x0a60…0a80 65 0a 20 20 20 20 20 70 72 6f 67 72 61 6d 20 74 68 72 6f 75 67 68 20 74 68 65 20 70 72 6f 63 65   ┆e      program through the proce┆
0x0a80…0aa0 64 75 72 61 6c 20 69 6e 74 65 72 66 61 63 65 2e 20 20 42 65 63 61 75 73 65 20 74 68 69 73 20 63   ┆dural interface.  Because this c┆
0x0aa0…0ac0 6f 6e 2d 0a 20 20 20 20 20 64 69 74 69 6f 6e 20 69 73 20 6e 6f 74 20 61 73 73 75 6d 65 64 20 74   ┆on-      dition is not assumed t┆
0x0ac0…0ae0 6f 20 62 65 20 66 61 74 61 6c 2c 20 69 74 20 69 73 20 61 63 63 65 70 74 61 62 6c 65 20 66 6f 72   ┆o be fatal, it is acceptable for┆
0x0ae0…0b00 20 79 6f 75 72 0a 0a 0a 0a 0a 0a 0a 20 20 20 20 20 65 72 72 6f 72 20 68 61 6e 64 6c 65 72 20 74   ┆ your            error handler t┆
0x0b00…0b20 6f 20 72 65 74 75 72 6e 2e 20 20 48 6f 77 65 76 65 72 2c 20 74 68 65 20 65 72 72 6f 72 20 68 61   ┆o return.  However, the error ha┆
0x0b20…0b40 6e 64 6c 65 72 20 73 68 6f 75 6c 64 0a 20 20 20 20 20 6e 6f 74 20 63 61 6c 6c 20 61 6e 79 20 66   ┆ndler should      not call any f┆
0x0b40…0b60 75 6e 63 74 69 6f 6e 73 20 28 64 69 72 65 63 74 6c 79 20 6f 72 20 69 6e 64 69 72 65 63 74 6c 79   ┆unctions (directly or indirectly┆
0x0b60…0b80 29 20 6f 6e 20 74 68 65 0a 20 20 20 20 20 64 69 73 70 6c 61 79 20 74 68 61 74 20 77 69 6c 6c 20   ┆) on the      display that will ┆
0x0b80…0ba0 67 65 6e 65 72 61 74 65 20 70 72 6f 74 6f 63 6f 6c 20 72 65 71 75 65 73 74 73 20 6f 72 20 74 68   ┆generate protocol requests or th┆
0x0ba0…0bc0 61 74 20 77 69 6c 6c 0a 20 20 20 20 20 6c 6f 6f 6b 20 66 6f 72 20 69 6e 70 75 74 20 65 76 65 6e   ┆at will      look for input even┆
0x0bc0…0be0 74 73 2e 20 20 54 68 65 20 70 72 65 76 69 6f 75 73 20 65 72 72 6f 72 20 68 61 6e 64 6c 65 72 20   ┆ts.  The previous error handler ┆
0x0be0…0c00 69 73 0a 20 20 20 20 20 72 65 74 75 72 6e 65 64 2e 0a 0a 20 20 20 20 20 54 68 65 20 5f 08 58 5f   ┆is      returned.       The _ X_┆
0x0c00…0c20 08 47 5f 08 65 5f 08 74 5f 08 45 5f 08 72 5f 08 72 5f 08 6f 5f 08 72 5f 08 54 5f 08 65 5f 08 78   ┆ G_ e_ t_ E_ r_ r_ o_ r_ T_ e_ x┆
0x0c20…0c40 5f 08 74 20 66 75 6e 63 74 69 6f 6e 20 63 6f 70 69 65 73 20 61 20 6e 75 6c 6c 2d 74 65 72 6d 69   ┆_ t function copies a null-termi┆
0x0c40…0c60 6e 61 74 65 64 20 73 74 72 69 6e 67 0a 20 20 20 20 20 64 65 73 63 72 69 62 69 6e 67 20 74 68 65   ┆nated string      describing the┆
0x0c60…0c80 20 73 70 65 63 69 66 69 65 64 20 65 72 72 6f 72 20 63 6f 64 65 20 69 6e 74 6f 20 74 68 65 20 73   ┆ specified error code into the s┆
0x0c80…0ca0 70 65 63 69 66 69 65 64 0a 20 20 20 20 20 62 75 66 66 65 72 2e 20 20 49 74 20 69 73 20 72 65 63   ┆pecified      buffer.  It is rec┆
0x0ca0…0cc0 6f 6d 6d 65 6e 64 65 64 20 74 68 61 74 20 79 6f 75 20 75 73 65 20 74 68 69 73 20 66 75 6e 63 74   ┆ommended that you use this funct┆
0x0cc0…0ce0 69 6f 6e 20 74 6f 0a 20 20 20 20 20 6f 62 74 61 69 6e 20 61 6e 20 65 72 72 6f 72 20 64 65 73 63   ┆ion to      obtain an error desc┆
0x0ce0…0d00 72 69 70 74 69 6f 6e 20 62 65 63 61 75 73 65 20 65 78 74 65 6e 73 69 6f 6e 73 20 74 6f 20 58 6c   ┆ription because extensions to Xl┆
0x0d00…0d20 69 62 20 6d 61 79 0a 20 20 20 20 20 64 65 66 69 6e 65 20 74 68 65 69 72 20 6f 77 6e 20 65 72 72   ┆ib may      define their own err┆
0x0d20…0d40 6f 72 20 63 6f 64 65 73 20 61 6e 64 20 65 72 72 6f 72 20 73 74 72 69 6e 67 73 2e 0a 0a 20 20 20   ┆or codes and error strings.     ┆
0x0d40…0d60 20 20 54 68 65 20 5f 08 58 5f 08 44 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 5f 08   ┆  The _ X_ D_ i_ s_ p_ l_ a_ y_ ┆
0x0d60…0d80 4e 5f 08 61 5f 08 6d 5f 08 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20   ┆N_ a_ m_ e function returns the ┆
0x0d80…0da0 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 69 73 70 6c 61 79 0a 20 20 20 20 20 74 68 61 74 20 5f 08   ┆name of the display      that _ ┆
0x0da0…0dc0 58 5f 08 4f 5f 08 70 5f 08 65 5f 08 6e 5f 08 44 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f   ┆X_ O_ p_ e_ n_ D_ i_ s_ p_ l_ a_┆
0x0dc0…0de0 08 79 20 77 6f 75 6c 64 20 61 74 74 65 6d 70 74 20 74 6f 20 75 73 65 2e 20 20 49 66 20 61 20 4e   ┆ y would attempt to use.  If a N┆
0x0de0…0e00 55 4c 4c 20 73 74 72 69 6e 67 20 69 73 0a 20 20 20 20 20 73 70 65 63 69 66 69 65 64 2c 20 5f 08   ┆ULL string is      specified, _ ┆
0x0e00…0e20 58 5f 08 44 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 5f 08 4e 5f 08 61 5f 08 6d 5f   ┆X_ D_ i_ s_ p_ l_ a_ y_ N_ a_ m_┆
0x0e20…0e40 08 65 20 6c 6f 6f 6b 73 20 69 6e 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 66 6f 72 20   ┆ e looks in the environment for ┆
0x0e40…0e60 74 68 65 0a 20 20 20 20 20 64 69 73 70 6c 61 79 20 61 6e 64 20 72 65 74 75 72 6e 73 20 74 68 65   ┆the      display and returns the┆
0x0e60…0e80 20 64 69 73 70 6c 61 79 20 6e 61 6d 65 20 74 68 61 74 20 5f 08 58 5f 08 4f 5f 08 70 5f 08 65 5f   ┆ display name that _ X_ O_ p_ e_┆
0x0e80…0ea0 08 6e 5f 08 44 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 20 77 6f 75 6c 64 0a 20 20   ┆ n_ D_ i_ s_ p_ l_ a_ y would   ┆
0x0ea0…0ec0 20 20 20 61 74 74 65 6d 70 74 20 74 6f 20 75 73 65 2e 20 20 54 68 69 73 20 6d 61 6b 65 73 20 69   ┆   attempt to use.  This makes i┆
0x0ec0…0ee0 74 20 65 61 73 69 65 72 20 74 6f 20 72 65 70 6f 72 74 20 74 6f 20 74 68 65 20 75 73 65 72 0a 20   ┆t easier to report to the user  ┆
0x0ee0…0f00 20 20 20 20 70 72 65 63 69 73 65 6c 79 20 77 68 69 63 68 20 64 69 73 70 6c 61 79 20 74 68 65 20   ┆    precisely which display the ┆
0x0f00…0f20 70 72 6f 67 72 61 6d 20 61 74 74 65 6d 70 74 65 64 20 74 6f 20 6f 70 65 6e 20 77 68 65 6e 0a 20   ┆program attempted to open when  ┆
0x0f20…0f40 20 20 20 20 74 68 65 20 69 6e 69 74 69 61 6c 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 74 74 65 6d   ┆    the initial connection attem┆
0x0f40…0f60 70 74 20 66 61 69 6c 65 64 2e 0a 0a 20 20 20 20 20 54 68 65 20 5f 08 58 5f 08 53 5f 08 65 5f 08   ┆pt failed.       The _ X_ S_ e_ ┆
0x0f60…0f80 74 5f 08 49 5f 08 4f 5f 08 45 5f 08 72 5f 08 72 5f 08 6f 5f 08 72 5f 08 48 5f 08 61 5f 08 6e 5f   ┆t_ I_ O_ E_ r_ r_ o_ r_ H_ a_ n_┆
0x0f80…0fa0 08 64 5f 08 6c 5f 08 65 5f 08 72 20 73 65 74 73 20 74 68 65 20 66 61 74 61 6c 20 49 2f 4f 20 65   ┆ d_ l_ e_ r sets the fatal I/O e┆
0x0fa0…0fc0 72 72 6f 72 20 68 61 6e 64 6c 65 72 2e 0a 20 20 20 20 20 58 6c 69 62 20 63 61 6c 6c 73 20 74 68   ┆rror handler.      Xlib calls th┆
0x0fc0…0fe0 65 20 70 72 6f 67 72 61 6d 27 73 20 73 75 70 70 6c 69 65 64 20 65 72 72 6f 72 20 68 61 6e 64 6c   ┆e program's supplied error handl┆
0x0fe0…1000 65 72 20 69 66 20 61 6e 79 20 73 6f 72 74 0a 20 20 20 20 20 6f 66 20 73 79 73 74 65 6d 20 63 61   ┆er if any sort      of system ca┆
0x1000…1020 6c 6c 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 28 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 68   ┆ll error occurs (for example, th┆
0x1020…1040 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 0a 20 20 20 20 20 74 68 65 20 73 65 72 76 65 72 20   ┆e connection to      the server ┆
0x1040…1060 77 61 73 20 6c 6f 73 74 29 2e 20 20 54 68 69 73 20 69 73 20 61 73 73 75 6d 65 64 20 74 6f 20 62   ┆was lost).  This is assumed to b┆
0x1060…1080 65 20 61 20 66 61 74 61 6c 20 63 6f 6e 64 69 2d 0a 20 20 20 20 20 74 69 6f 6e 2c 20 61 6e 64 20   ┆e a fatal condi-      tion, and ┆
0x1080…10a0 74 68 65 20 63 61 6c 6c 65 64 20 72 6f 75 74 69 6e 65 20 73 68 6f 75 6c 64 20 6e 6f 74 20 72 65   ┆the called routine should not re┆
0x10a0…10c0 74 75 72 6e 2e 20 20 49 66 20 74 68 65 20 49 2f 4f 0a 20 20 20 20 20 65 72 72 6f 72 20 68 61 6e   ┆turn.  If the I/O      error han┆
0x10c0…10e0 64 6c 65 72 20 64 6f 65 73 20 72 65 74 75 72 6e 2c 20 74 68 65 20 63 6c 69 65 6e 74 20 70 72 6f   ┆dler does return, the client pro┆
0x10e0…1100 63 65 73 73 20 65 78 69 74 73 2e 0a 0a 20 20 20 20 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20   ┆cess exits.       Note that the ┆
0x1100…1120 70 72 65 76 69 6f 75 73 20 65 72 72 6f 72 20 68 61 6e 64 6c 65 72 20 69 73 20 72 65 74 75 72 6e   ┆previous error handler is return┆
0x1120…1140 65 64 2e 0a 0a 20 20 20 20 20 54 68 65 20 5f 08 58 5f 08 47 5f 08 65 5f 08 74 5f 08 45 5f 08 72   ┆ed.       The _ X_ G_ e_ t_ E_ r┆
0x1140…1160 5f 08 72 5f 08 6f 5f 08 72 5f 08 44 5f 08 61 5f 08 74 5f 08 61 5f 08 62 5f 08 61 5f 08 73 5f 08   ┆_ r_ o_ r_ D_ a_ t_ a_ b_ a_ s_ ┆
0x1160…1180 65 5f 08 54 5f 08 65 5f 08 78 5f 08 74 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 61   ┆e_ T_ e_ x_ t function returns a┆
0x1180…11a0 20 6d 65 73 73 61 67 65 20 28 6f 72 20 74 68 65 0a 20 20 20 20 20 64 65 66 61 75 6c 74 20 6d 65   ┆ message (or the      default me┆
0x11a0…11c0 73 73 61 67 65 29 20 66 72 6f 6d 20 74 68 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 64 61   ┆ssage) from the error message da┆
0x11c0…11e0 74 61 62 61 73 65 2e 20 20 58 6c 69 62 20 75 73 65 73 0a 20 20 20 20 20 74 68 69 73 20 66 75 6e   ┆tabase.  Xlib uses      this fun┆
0x11e0…1200 63 74 69 6f 6e 20 69 6e 74 65 72 6e 61 6c 6c 79 20 74 6f 20 6c 6f 6f 6b 20 75 70 20 69 74 73 20   ┆ction internally to look up its ┆
0x1200…1220 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 2e 20 20 4f 6e 0a 20 20 20 20 20 61 20 55 4e 49 58 2d   ┆error messages.  On      a UNIX-┆
0x1220…1240 62 61 73 65 64 20 73 79 73 74 65 6d 2c 20 74 68 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20   ┆based system, the error message ┆
0x1240…1260 64 61 74 61 62 61 73 65 20 69 73 0a 20 20 20 20 20 2f 5f 08 75 5f 08 73 5f 08 72 2f 5f 08 6c 5f   ┆database is      /_ u_ s_ r/_ l_┆
0x1260…1280 08 69 5f 08 62 2f 5f 08 58 5f 08 31 5f 08 31 2f 5f 08 58 5f 08 45 5f 08 72 5f 08 72 5f 08 6f 5f   ┆ i_ b/_ X_ 1_ 1/_ X_ E_ r_ r_ o_┆
0x1280…12a0 08 72 5f 08 44 5f 08 42 2e 0a 0a 20 20 20 20 20 54 68 65 20 6e 61 6d 65 20 61 72 67 75 6d 65 6e   ┆ r_ D_ B.       The name argumen┆
0x12a0…12c0 74 20 73 68 6f 75 6c 64 20 67 65 6e 65 72 61 6c 6c 79 20 62 65 20 74 68 65 20 6e 61 6d 65 20 6f   ┆t should generally be the name o┆
0x12c0…12e0 66 20 79 6f 75 72 0a 20 20 20 20 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e 20 20 54 68 65 20 6d 65   ┆f your      application.  The me┆
0x12e0…1300 73 73 61 67 65 20 61 72 67 75 6d 65 6e 74 20 73 68 6f 75 6c 64 20 69 6e 64 69 63 61 74 65 20 77   ┆ssage argument should indicate w┆
0x1300…1320 68 69 63 68 0a 20 20 20 20 20 74 79 70 65 20 6f 66 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20   ┆hich      type of error message ┆
0x1320…1340 79 6f 75 20 77 61 6e 74 2e 20 20 58 6c 69 62 20 75 73 65 73 20 74 68 72 65 65 20 70 72 65 64 65   ┆you want.  Xlib uses three prede┆
0x1340…1360 66 69 6e 65 64 0a 20 20 20 20 20 6d 65 73 73 61 67 65 20 74 79 70 65 73 20 74 6f 20 72 65 70 6f   ┆fined      message types to repo┆
0x1360…1380 72 74 20 65 72 72 6f 72 73 20 28 75 70 70 65 72 63 61 73 65 20 61 6e 64 20 6c 6f 77 65 72 63 61   ┆rt errors (uppercase and lowerca┆
0x1380…13a0 73 65 0a 20 20 20 20 20 6d 61 74 74 65 72 29 3a 0a 0a 20 20 20 20 20 58 50 72 6f 74 6f 45 72 72   ┆se      matter):       XProtoErr┆
0x13a0…13c0 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 68 65 20 70 72 6f 74 6f 63 6f 6c 20 65   ┆or                The protocol e┆
0x13c0…13e0 72 72 6f 72 20 6e 75 6d 62 65 72 20 69 73 20 75 73 65 64 20 61 73 20 61 20 73 74 72 69 6e 67 20   ┆rror number is used as a string ┆
0x13e0…1400 66 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 6d 65 73 73 61 67 65 20 61   ┆for                the message a┆
0x1400…1420 72 67 75 6d 65 6e 74 2e 0a 0a 20 20 20 20 20 58 6c 69 62 4d 65 73 73 61 67 65 0a 20 20 20 20 20   ┆rgument.       XlibMessage      ┆
0x1420…1440 20 20 20 20 20 20 20 20 20 20 54 68 65 73 65 20 61 72 65 20 74 68 65 20 6d 65 73 73 61 67 65 20   ┆          These are the message ┆
0x1440…1460 73 74 72 69 6e 67 73 20 74 68 61 74 20 61 72 65 20 75 73 65 64 20 69 6e 74 65 72 2d 0a 20 20 20   ┆strings that are used inter-    ┆
0x1460…1480 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 6c 6c 79 20 62 79 20 74 68 65 20 6c 69 62 72 61 72 79   ┆            nally by the library┆
0x1480…14a0 2e 0a 0a 20 20 20 20 20 58 52 65 71 75 65 73 74 20 20 46 6f 72 20 61 20 63 6f 72 65 20 70 72 6f   ┆.       XRequest  For a core pro┆
0x14a0…14c0 74 6f 63 6f 6c 20 72 65 71 75 65 73 74 2c 20 74 68 65 20 6d 61 6a 6f 72 20 72 65 71 75 65 73 74   ┆tocol request, the major request┆
0x14c0…14e0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 72 6f 74 6f 63 6f 6c 20 6e 75 6d 62 65 72 20   ┆                protocol number ┆
0x14e0…1500 69 73 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 6d 65 73 73 61 67 65 20 61 72 67 75 6d 65 6e 74   ┆is used for the message argument┆
0x1500…1520 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 46 6f 72 20 61 6e 20 65 78 74 65 6e 73 69 6f   ┆.                For an extensio┆
0x1520…1540 6e 20 72 65 71 75 65 73 74 2c 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e 20 6e 61 6d 65 20 28 61   ┆n request, the extension name (a┆
0x1540…1560 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 67 69 76 65 6e 20 62 79 20 5f 08 49 5f 08 6e   ┆s                given by _ I_ n┆
0x1560…1580 5f 08 69 5f 08 74 5f 08 45 5f 08 78 5f 08 74 5f 08 65 5f 08 6e 5f 08 73 5f 08 69 5f 08 6f 5f 08   ┆_ i_ t_ E_ x_ t_ e_ n_ s_ i_ o_ ┆
0x1580…15a0 6e 29 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 70 65 72 69 6f 64 20 28 2e 29 0a 20 20 20 20   ┆n) followed by a period (.)     ┆
0x15a0…15c0 20 20 20 20 20 20 20 20 20 20 20 61 6e 64 20 74 68 65 20 6d 69 6e 6f 72 20 72 65 71 75 65 73 74   ┆           and the minor request┆
0x15c0…15e0 20 70 72 6f 74 6f 63 6f 6c 20 6e 75 6d 62 65 72 20 69 73 20 75 73 65 64 20 66 6f 72 0a 20 20 20   ┆ protocol number is used for    ┆
0x15e0…1600 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 6d 65 73 73 61 67 65 20 61 72 67 75 6d 65 6e 74   ┆            the message argument┆
0x1600…1620 2e 20 20 49 66 20 6e 6f 20 73 74 72 69 6e 67 20 69 73 20 66 6f 75 6e 64 20 69 6e 0a 20 20 20 20   ┆.  If no string is found in     ┆
0x1620…1640 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 65 72 72 6f 72 20 64 61 74 61 62 61 73 65 2c 20 74   ┆           the error database, t┆
0x1640…1660 68 65 20 64 65 66 61 75 6c 74 5f 73 74 72 69 6e 67 20 69 73 20 72 65 74 75 72 6e 65 64 0a 20 20   ┆he default_string is returned   ┆
0x1660…1680 20 20 20 20 20 20 20 20 20 20 20 20 20 74 6f 20 74 68 65 20 62 75 66 66 65 72 20 61 72 67 75 6d   ┆             to the buffer argum┆
0x1680…16a0 65 6e 74 2e 0a 0a 53 08 53 08 53 08 53 45 08 45 08 45 08 45 45 08 45 08 45 08 45 20 41 08 41 08   ┆ent.  S S S SE E E EE E E E A A ┆
0x16a0…16c0 41 08 41 4c 08 4c 08 4c 08 4c 53 08 53 08 53 08 53 4f 08 4f 08 4f 08 4f 0a 20 20 20 20 20 58 4f   ┆A AL L L LS S S SO O O O      XO┆
0x16c0…16e0 70 65 6e 44 69 73 70 6c 61 79 28 33 58 31 31 29 2c 20 58 53 79 6e 63 68 72 6f 6e 69 7a 65 28 33   ┆penDisplay(3X11), XSynchronize(3┆
0x16e0…1700 58 31 31 29 0a 0a 0a 0a 0a 0a 0a 20 20 20 20 20 5f 08 58 5f 08 6c 5f 08 69 5f 08 62 20 2d 20 5f   ┆X11)            _ X_ l_ i_ b - _┆
0x1700…1720 08 43 20 5f 08 4c 5f 08 61 5f 08 6e 5f 08 67 5f 08 75 5f 08 61 5f 08 67 5f 08 65 20 5f 08 58 20   ┆ C _ L_ a_ n_ g_ u_ a_ g_ e _ X ┆
0x1720…1740 5f 08 49 5f 08 6e 5f 08 74 5f 08 65 5f 08 72 5f 08 66 5f 08 61 5f 08 63 5f 08 65 0a 0a 41 75 67   ┆_ I_ n_ t_ e_ r_ f_ a_ c_ e  Aug┆
0x1740…1760 75 73 74 20 31 39 39 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20   ┆ust 1991                        ┆
0x1760…1780 20 20 20 20 20 54 58 20 50 72 6f 67 72 61 6d 6d 65 72 27 73 20 52 65 66 65 72 65 6e 63 65 0a 0a   ┆     TX Programmer's Reference  ┆
0x1780…17a0 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a   ┆                                ┆
0x17a0…17b8 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a                           ┆                        ┆