DataMuseum.dk

Presents historical artifacts from the history of:

RC9000

This is an automatic "excavation" of a thematic subset of
artifacts from Datamuseum.dk's BitArchive.

See our Wiki for more about RC9000

Excavated with: AutoArchaeologist - Free & Open Source Software.


top - download
Index: g

⟦49906b49e⟧

    Length: 3851 (0xf0b)
    Names: »getsubopt.3«

Derivation

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

Default Hex Dump

0x000…020 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_┆
0x020…040 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┆
0x040…060 69 6f 6e 73 20 20 20 20 20 20 20 20 20 20 20 20 67 65 74 73 75 62 6f 70 74 28 33 29 0a 0a 0a 0a   ┆ions            getsubopt(3)    ┆
0x060…080 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    ┆
0x080…0a0 20 20 67 65 74 73 75 62 6f 70 74 20 2d 20 70 61 72 73 65 20 73 75 62 6f 70 74 69 6f 6e 73 20 66   ┆  getsubopt - parse suboptions f┆
0x0a0…0c0 72 6f 6d 20 61 20 73 74 72 69 6e 67 0a 0a 53 08 53 08 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08   ┆rom a string  S S S SY Y Y YN N ┆
0x0c0…0e0 4e 08 4e 54 08 54 08 54 08 54 41 08 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 23 08   ┆N NT T T TA A A AX X X X      # ┆
0x0e0…100 23 08 23 08 23 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 63 08 63 08 63 08 63 6c 08 6c 08 6c 08   ┆# # #i i i in n n nc c c cl l l ┆
0x100…120 6c 75 08 75 08 75 08 75 64 08 64 08 64 08 64 65 08 65 08 65 08 65 20 3c 08 3c 08 3c 08 3c 73 08   ┆lu u u ud d d de e e e < < < <s ┆
0x120…140 73 08 73 08 73 74 08 74 08 74 08 74 64 08 64 08 64 08 64 6c 08 6c 08 6c 08 6c 69 08 69 08 69 08   ┆s s st t t td d d dl l l li i i ┆
0x140…160 69 62 08 62 08 62 08 62 2e 08 2e 08 2e 08 2e 68 08 68 08 68 08 68 3e 08 3e 08 3e 08 3e 0a 0a 20   ┆ib b b b. . . .h h h h> > > >   ┆
0x160…180 20 20 20 20 69 08 69 08 69 08 69 6e 08 6e 08 6e 08 6e 74 08 74 08 74 08 74 20 67 08 67 08 67 08   ┆    i i i in n n nt t t t g g g ┆
0x180…1a0 67 65 08 65 08 65 08 65 74 08 74 08 74 08 74 73 08 73 08 73 08 73 75 08 75 08 75 08 75 62 08 62   ┆ge e e et t t ts s s su u u ub b┆
0x1a0…1c0 08 62 08 62 6f 08 6f 08 6f 08 6f 70 08 70 08 70 08 70 74 08 74 08 74 08 74 28 08 28 08 28 08 28   ┆ b bo o o op p p pt t t t( ( ( (┆
0x1c0…1e0 6f 08 6f 08 6f 08 6f 70 08 70 08 70 08 70 74 08 74 08 74 08 74 69 08 69 08 69 08 69 6f 08 6f 08   ┆o o o op p p pt t t ti i i io o ┆
0x1e0…200 6f 08 6f 6e 08 6e 08 6e 08 6e 70 08 70 08 70 08 70 2c 08 2c 08 2c 08 2c 20 74 08 74 08 74 08 74   ┆o on n n np p p p, , , , t t t t┆
0x200…220 6f 08 6f 08 6f 08 6f 6b 08 6b 08 6b 08 6b 65 08 65 08 65 08 65 6e 08 6e 08 6e 08 6e 73 08 73 08   ┆o o o ok k k ke e e en n n ns s ┆
0x220…240 73 08 73 2c 08 2c 08 2c 08 2c 20 76 08 76 08 76 08 76 61 08 61 08 61 08 61 6c 08 6c 08 6c 08 6c   ┆s s, , , , v v v va a a al l l l┆
0x240…260 75 08 75 08 75 08 75 65 08 65 08 65 08 65 70 08 70 08 70 08 70 29 08 29 08 29 08 29 0a 20 20 20   ┆u u u ue e e ep p p p) ) ) )    ┆
0x260…280 20 20 63 08 63 08 63 08 63 68 08 68 08 68 08 68 61 08 61 08 61 08 61 72 08 72 08 72 08 72 20 2a   ┆  c c c ch h h ha a a ar r r r *┆
0x280…2a0 08 2a 08 2a 08 2a 2a 08 2a 08 2a 08 2a 6f 08 6f 08 6f 08 6f 70 08 70 08 70 08 70 74 08 74 08 74   ┆ * * ** * * *o o o op p p pt t t┆
0x2a0…2c0 08 74 69 08 69 08 69 08 69 6f 08 6f 08 6f 08 6f 6e 08 6e 08 6e 08 6e 70 08 70 08 70 08 70 2c 08   ┆ ti i i io o o on n n np p p p, ┆
0x2c0…2e0 2c 08 2c 08 2c 20 2a 08 2a 08 2a 08 2a 74 08 74 08 74 08 74 6f 08 6f 08 6f 08 6f 6b 08 6b 08 6b   ┆, , , * * * *t t t to o o ok k k┆
0x2e0…300 08 6b 65 08 65 08 65 08 65 6e 08 6e 08 6e 08 6e 73 08 73 08 73 08 73 2c 08 2c 08 2c 08 2c 20 2a   ┆ ke e e en n n ns s s s, , , , *┆
0x300…320 08 2a 08 2a 08 2a 2a 08 2a 08 2a 08 2a 76 08 76 08 76 08 76 61 08 61 08 61 08 61 6c 08 6c 08 6c   ┆ * * ** * * *v v v va a a al l l┆
0x320…340 08 6c 75 08 75 08 75 08 75 65 08 65 08 65 08 65 70 08 70 08 70 08 70 3b 08 3b 08 3b 08 3b 0a 0a   ┆ lu u u ue e e ep p p p; ; ; ;  ┆
0x340…360 44 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   ┆D D D DE E E ES S S SC C C CR R ┆
0x360…380 52 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   ┆R RI I I IP P P PT T T TI I I IO┆
0x380…3a0 08 4f 08 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 5f 08 67 5f 08 65 5f 08 74 5f 08 73 5f   ┆ O O ON N N N      _ g_ e_ t_ s_┆
0x3a0…3c0 08 75 5f 08 62 5f 08 6f 5f 08 70 5f 08 74 20 70 61 72 73 65 73 20 73 75 62 6f 70 74 69 6f 6e 73   ┆ u_ b_ o_ p_ t parses suboptions┆
0x3c0…3e0 20 69 6e 20 61 20 66 6c 61 67 20 61 72 67 75 6d 65 6e 74 20 74 68 61 74 20 77 61 73 20 69 6e 69   ┆ in a flag argument that was ini┆
0x3e0…400 2d 0a 20 20 20 20 20 74 69 61 6c 6c 79 20 70 61 72 73 65 64 20 62 79 20 5f 08 67 5f 08 65 5f 08   ┆-      tially parsed by _ g_ e_ ┆
0x400…420 74 5f 08 6f 5f 08 70 5f 08 74 2e 20 20 54 68 65 73 65 20 73 75 62 6f 70 74 69 6f 6e 73 20 61 72   ┆t_ o_ p_ t.  These suboptions ar┆
0x420…440 65 20 73 65 70 61 72 61 74 65 64 20 62 79 0a 20 20 20 20 20 63 6f 6d 6d 61 73 20 61 6e 64 20 6d   ┆e separated by      commas and m┆
0x440…460 61 79 20 63 6f 6e 73 69 73 74 20 6f 66 20 65 69 74 68 65 72 20 61 20 73 69 6e 67 6c 65 20 74 6f   ┆ay consist of either a single to┆
0x460…480 6b 65 6e 20 6f 72 20 61 20 74 6f 6b 65 6e 2d 0a 20 20 20 20 20 76 61 6c 75 65 20 70 61 69 72 20   ┆ken or a token-      value pair ┆
0x480…4a0 73 65 70 61 72 61 74 65 64 20 62 79 20 61 6e 20 65 71 75 61 6c 20 73 69 67 6e 2e 20 53 69 6e 63   ┆separated by an equal sign. Sinc┆
0x4a0…4c0 65 20 63 6f 6d 6d 61 73 20 64 65 6c 69 6d 69 74 0a 20 20 20 20 20 73 75 62 6f 70 74 69 6f 6e 73   ┆e commas delimit      suboptions┆
0x4c0…4e0 20 69 6e 20 74 68 65 20 6f 70 74 69 6f 6e 20 73 74 72 69 6e 67 2c 20 74 68 65 79 20 61 72 65 20   ┆ in the option string, they are ┆
0x4e0…500 6e 6f 74 20 61 6c 6c 6f 77 65 64 20 74 6f 20 62 65 0a 20 20 20 20 20 70 61 72 74 20 6f 66 20 74   ┆not allowed to be      part of t┆
0x500…520 68 65 20 73 75 62 6f 70 74 69 6f 6e 20 6f 72 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 61 20 73   ┆he suboption or the value of a s┆
0x520…540 75 62 6f 70 74 69 6f 6e 2e 0a 0a 20 20 20 20 20 5f 08 67 5f 08 65 5f 08 74 5f 08 73 5f 08 75 5f   ┆uboption.       _ g_ e_ t_ s_ u_┆
0x540…560 08 62 5f 08 6f 5f 08 70 5f 08 74 20 74 61 6b 65 73 20 74 68 65 20 61 64 64 72 65 73 73 20 6f 66   ┆ b_ o_ p_ t takes the address of┆
0x560…580 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6f 70 74 69 6f 6e 0a 20 20 20 20 20 73 74   ┆ a pointer to the option      st┆
0x580…5a0 72 69 6e 67 2c 20 61 20 76 65 63 74 6f 72 20 6f 66 20 70 6f 73 73 69 62 6c 65 20 74 6f 6b 65 6e   ┆ring, a vector of possible token┆
0x5a0…5c0 73 2c 20 61 6e 64 20 74 68 65 20 61 64 64 72 65 73 73 20 6f 66 20 61 0a 20 20 20 20 20 76 61 6c   ┆s, and the address of a      val┆
0x5c0…5e0 75 65 20 73 74 72 69 6e 67 20 70 6f 69 6e 74 65 72 2e 20 20 49 74 20 72 65 74 75 72 6e 73 20 74   ┆ue string pointer.  It returns t┆
0x5e0…600 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68 65 20 74 6f 6b 65 6e 0a 20 20 20 20 20 74 68 61 74 20   ┆he index of the token      that ┆
0x600…620 6d 61 74 63 68 65 64 20 74 68 65 20 73 75 62 6f 70 74 69 6f 6e 20 69 6e 20 74 68 65 20 69 6e 70   ┆matched the suboption in the inp┆
0x620…640 75 74 20 73 74 72 69 6e 67 20 6f 72 20 2d 31 20 69 66 0a 20 20 20 20 20 74 68 65 72 65 20 77 61   ┆ut string or -1 if      there wa┆
0x640…660 73 20 6e 6f 20 6d 61 74 63 68 2e 20 20 49 66 20 74 68 65 20 6f 70 74 69 6f 6e 20 73 74 72 69 6e   ┆s no match.  If the option strin┆
0x660…680 67 20 61 74 20 5f 08 6f 5f 08 70 5f 08 74 5f 08 69 5f 08 6f 5f 08 6e 5f 08 70 20 63 6f 6e 2d 0a   ┆g at _ o_ p_ t_ i_ o_ n_ p con- ┆
0x680…6a0 20 20 20 20 20 74 61 69 6e 73 20 6f 6e 6c 79 20 6f 6e 65 20 73 75 62 6f 62 74 69 6f 6e 2c 20 5f   ┆     tains only one subobtion, _┆
0x6a0…6c0 08 67 5f 08 65 5f 08 74 5f 08 73 5f 08 75 5f 08 62 5f 08 6f 5f 08 70 5f 08 74 20 75 70 64 61 74   ┆ g_ e_ t_ s_ u_ b_ o_ p_ t updat┆
0x6c0…6e0 65 73 20 5f 08 6f 5f 08 70 5f 08 74 5f 08 69 5f 08 6f 5f 08 6e 5f 08 70 20 74 6f 20 70 6f 69 6e   ┆es _ o_ p_ t_ i_ o_ n_ p to poin┆
0x6e0…700 74 0a 20 20 20 20 20 74 6f 20 74 68 65 20 6e 75 6c 6c 20 63 68 61 72 61 63 74 65 72 20 61 74 20   ┆t      to the null character at ┆
0x700…720 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 73 74 72 69 6e 67 3b 20 6f 74 68 65 72 77 69 73 65   ┆the end of the string; otherwise┆
0x720…740 20 69 74 0a 20 20 20 20 20 69 73 6f 6c 61 74 65 73 20 74 68 65 20 73 75 62 6f 70 74 69 6f 6e 20   ┆ it      isolates the suboption ┆
0x740…760 62 79 20 72 65 70 6c 61 63 69 6e 67 20 74 68 65 20 63 6f 6d 6d 61 20 73 65 70 61 72 61 74 6f 72   ┆by replacing the comma separator┆
0x760…780 20 77 69 74 68 0a 20 20 20 20 20 61 20 6e 75 6c 6c 20 63 68 61 72 61 63 74 65 72 2c 20 61 6e 64   ┆ with      a null character, and┆
0x780…7a0 20 75 70 64 61 74 65 73 20 5f 08 6f 5f 08 70 5f 08 74 5f 08 69 5f 08 6f 5f 08 6e 5f 08 70 20 74   ┆ updates _ o_ p_ t_ i_ o_ n_ p t┆
0x7a0…7c0 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 73 74 61 72 74 0a 20 20 20 20 20 6f 66 20 74 68 65   ┆o point to the start      of the┆
0x7c0…7e0 20 6e 65 78 74 20 73 75 62 6f 70 74 69 6f 6e 2e 20 20 49 66 20 74 68 65 20 73 75 62 6f 70 74 69   ┆ next suboption.  If the subopti┆
0x7e0…800 6f 6e 20 68 61 73 20 61 6e 20 61 73 73 6f 63 69 61 74 65 64 0a 20 20 20 20 20 76 61 6c 75 65 2c   ┆on has an associated      value,┆
0x800…820 20 5f 08 67 5f 08 65 5f 08 74 5f 08 73 5f 08 75 5f 08 62 5f 08 6f 5f 08 70 5f 08 74 20 75 70 64   ┆ _ g_ e_ t_ s_ u_ b_ o_ p_ t upd┆
0x820…840 61 74 65 73 20 5f 08 76 5f 08 61 5f 08 6c 5f 08 75 5f 08 65 5f 08 70 20 74 6f 20 70 6f 69 6e 74   ┆ates _ v_ a_ l_ u_ e_ p to point┆
0x840…860 20 74 6f 20 74 68 65 20 76 61 6c 75 65 27 73 0a 20 20 20 20 20 66 69 72 73 74 20 63 68 61 72 61   ┆ to the value's      first chara┆
0x860…880 63 74 65 72 2e 20 4f 74 68 65 72 77 69 73 65 20 69 74 20 73 65 74 73 20 5f 08 76 5f 08 61 5f 08   ┆cter. Otherwise it sets _ v_ a_ ┆
0x880…8a0 6c 5f 08 75 5f 08 65 5f 08 70 20 74 6f 20 4e 55 4c 4c 2e 0a 0a 20 20 20 20 20 54 68 65 20 74 6f   ┆l_ u_ e_ p to NULL.       The to┆
0x8a0…8c0 6b 65 6e 20 76 65 63 74 6f 72 20 69 73 20 6f 72 67 61 6e 69 7a 65 64 20 61 73 20 61 20 73 65 72   ┆ken vector is organized as a ser┆
0x8c0…8e0 69 65 73 20 6f 66 20 70 6f 69 6e 74 65 72 73 20 74 6f 0a 20 20 20 20 20 6e 75 6c 6c 20 73 74 72   ┆ies of pointers to      null str┆
0x8e0…900 69 6e 67 73 2e 20 20 54 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 74 6f 6b 65 6e 20 76 65 63 74   ┆ings.  The end of the token vect┆
0x900…920 6f 72 20 69 73 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 0a 20 20 20 20 20 61 20 6e 75 6c 6c 20   ┆or is identified by      a null ┆
0x920…940 70 6f 69 6e 74 65 72 2e 0a 0a 20 20 20 20 20 57 68 65 6e 20 5f 08 67 5f 08 65 5f 08 74 5f 08 73   ┆pointer.       When _ g_ e_ t_ s┆
0x940…960 5f 08 75 5f 08 62 5f 08 6f 5f 08 70 5f 08 74 20 72 65 74 75 72 6e 73 2c 20 69 66 20 5f 08 76 5f   ┆_ u_ b_ o_ p_ t returns, if _ v_┆
0x960…980 08 61 5f 08 6c 5f 08 75 5f 08 65 5f 08 70 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e   ┆ a_ l_ u_ e_ p is not NULL, then┆
0x980…9a0 20 74 68 65 0a 20 20 20 20 20 73 75 62 6f 70 74 69 6f 6e 20 70 72 6f 63 65 73 73 65 64 20 69 6e   ┆ the      suboption processed in┆
0x9a0…9c0 63 6c 75 64 65 64 20 61 20 76 61 6c 75 65 2e 20 20 54 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f   ┆cluded a value.  The calling pro┆
0x9c0…9e0 67 72 61 6d 0a 20 20 20 20 20 6d 61 79 20 75 73 65 20 74 68 69 73 20 69 6e 66 6f 72 6d 61 74 69   ┆gram      may use this informati┆
0x9e0…a00 6f 6e 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 69 66 20 74 68 65 20 70 72 65 73 65 6e 63 65 20   ┆on to determine if the presence ┆
0xa00…a20 6f 72 0a 20 20 20 20 20 6c 61 63 6b 20 6f 66 20 61 20 76 61 6c 75 65 20 66 6f 72 20 74 68 69 73   ┆or      lack of a value for this┆
0xa20…a40 20 73 75 62 6f 62 74 69 6f 6e 20 69 73 20 61 6e 20 65 72 72 6f 72 2e 0a 0a 20 20 20 20 20 41 64   ┆ subobtion is an error.       Ad┆
0xa40…a60 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 77 68 65 6e 20 5f 08 67 5f 08 65 5f 08 74 5f 08 73 5f 08 75   ┆ditionally, when _ g_ e_ t_ s_ u┆
0xa60…a80 5f 08 62 5f 08 6f 5f 08 70 5f 08 74 20 66 61 69 6c 73 20 74 6f 20 6d 61 74 63 68 20 74 68 65 20   ┆_ b_ o_ p_ t fails to match the ┆
0xa80…aa0 73 75 62 6f 70 74 69 6f 6e 0a 20 20 20 20 20 77 69 74 68 20 74 68 65 20 74 6f 6b 65 6e 73 20 69   ┆suboption      with the tokens i┆
0xaa0…ac0 6e 20 74 68 65 20 5f 08 74 5f 08 6f 5f 08 6b 5f 08 65 5f 08 6e 5f 08 73 20 61 72 72 61 79 2c 20   ┆n the _ t_ o_ k_ e_ n_ s array, ┆
0xac0…ae0 74 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f 67 72 61 6d 0a 20 20 20 20 20 73 68 6f 75 6c 64 20   ┆the calling program      should ┆
0xae0…b00 64 65 63 69 64 65 20 69 66 20 74 68 69 73 20 69 73 20 61 6e 20 65 72 72 6f 72 2c 20 6f 72 20 69   ┆decide if this is an error, or i┆
0xb00…b20 66 20 74 68 65 20 75 6e 72 65 63 6f 67 6e 69 7a 65 64 0a 20 20 20 20 20 6f 70 74 69 6f 6e 20 73   ┆f the unrecognized      option s┆
0xb20…b40 68 6f 75 6c 64 20 62 65 20 70 61 73 73 65 64 20 74 6f 20 61 6e 6f 74 68 65 72 20 70 72 6f 67 72   ┆hould be passed to another progr┆
0xb40…b60 61 6d 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 41   ┆am.  S S S SE E E EE E E E A A A┆
0xb60…b80 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 4c 69 62   ┆ AL L L LS S S SO O O O      Lib┆
0xb80…ba0 72 61 72 79 20 46 75 6e 63 74 69 6f 6e 73 20 28 33 29 3a 20 67 65 74 6f 70 74 0a 0a 52 08 52 08   ┆rary Functions (3): getopt  R R ┆
0xba0…bc0 52 08 52 45 08 45 08 45 08 45 54 08 54 08 54 08 54 55 08 55 08 55 08 55 52 08 52 08 52 08 52 4e   ┆R RE E E ET T T TU U U UR R R RN┆
0xbc0…be0 08 4e 08 4e 08 4e 20 56 08 56 08 56 08 56 41 08 41 08 41 08 41 4c 08 4c 08 4c 08 4c 55 08 55 08   ┆ N N N V V V VA A A AL L L LU U ┆
0xbe0…c00 55 08 55 45 08 45 08 45 08 45 0a 20 20 20 20 20 5f 08 67 5f 08 65 5f 08 74 5f 08 73 5f 08 75 5f   ┆U UE E E E      _ g_ e_ t_ s_ u_┆
0xc00…c20 08 62 5f 08 6f 5f 08 70 5f 08 74 20 72 65 74 75 72 6e 73 20 2d 31 20 77 68 65 6e 20 74 68 65 20   ┆ b_ o_ p_ t returns -1 when the ┆
0xc20…c40 74 6f 6b 65 6e 20 69 74 20 69 73 20 73 63 61 6e 6e 69 6e 67 20 69 73 20 6e 6f 74 20 69 6e 0a 20   ┆token it is scanning is not in  ┆
0xc40…c60 20 20 20 20 74 68 65 20 74 6f 6b 65 6e 20 76 65 63 74 6f 72 2e 20 20 54 68 65 20 76 61 72 69 61   ┆    the token vector.  The varia┆
0xc60…c80 62 6c 65 20 61 64 64 72 65 73 73 65 64 20 62 79 20 5f 08 76 5f 08 61 5f 08 6c 5f 08 75 5f 08 65   ┆ble addressed by _ v_ a_ l_ u_ e┆
0xc80…ca0 5f 08 70 20 63 6f 6e 74 61 69 6e 73 0a 20 20 20 20 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74   ┆_ p contains      a pointer to t┆
0xca0…cc0 68 65 20 66 69 72 73 74 20 63 68 61 72 61 63 74 65 72 20 6f 66 20 74 68 65 20 74 6f 6b 65 6e 20   ┆he first character of the token ┆
0xcc0…ce0 74 68 61 74 20 77 61 73 20 6e 6f 74 0a 20 20 20 20 20 72 65 63 6f 67 6e 69 7a 65 64 20 72 61 74   ┆that was not      recognized rat┆
0xce0…d00 68 65 72 20 74 68 61 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 76 61 6c 75 65 20 66 6f   ┆her than a pointer to a value fo┆
0xd00…d20 72 20 74 68 61 74 20 74 6f 6b 65 6e 2e 0a 0a 20 20 20 20 20 54 68 65 20 76 61 72 69 61 62 6c 65   ┆r that token.       The variable┆
0xd20…d40 20 61 64 64 72 65 73 73 65 64 20 62 79 20 5f 08 6f 5f 08 70 5f 08 74 5f 08 69 5f 08 6f 5f 08 6e   ┆ addressed by _ o_ p_ t_ i_ o_ n┆
0xd40…d60 5f 08 70 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 20 6e 65 78 74 20 6f 70 74 69 6f 6e 0a 20 20   ┆_ p points to the next option   ┆
0xd60…d80 20 20 20 74 6f 20 62 65 20 70 61 72 73 65 64 2c 20 6f 72 20 61 20 6e 75 6c 6c 20 63 68 61 72 61   ┆   to be parsed, or a null chara┆
0xd80…da0 63 74 65 72 20 69 66 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6d 6f 72 65 0a 20 20 20 20 20 6f   ┆cter if there are no more      o┆
0xda0…dc0 70 74 69 6f 6e 73 2e 0a 0a 4e 08 4e 08 4e 08 4e 4f 08 4f 08 4f 08 4f 54 08 54 08 54 08 54 45 08   ┆ptions.  N N N NO O O OT T T TE ┆
0xdc0…de0 45 08 45 08 45 53 08 53 08 53 08 53 0a 20 20 20 20 20 44 75 72 69 6e 67 20 70 61 72 73 69 6e 67   ┆E E ES S S S      During parsing┆
0xde0…e00 2c 20 63 6f 6d 6d 61 73 20 69 6e 20 74 68 65 20 6f 70 74 69 6f 6e 20 69 6e 70 75 74 20 73 74 72   ┆, commas in the option input str┆
0xe00…e20 69 6e 67 20 61 72 65 0a 0a 0a 0a 0a 0a 0a 20 20 20 20 20 63 68 61 6e 67 65 64 20 74 6f 20 6e 75   ┆ing are            changed to nu┆
0xe20…e40 6c 6c 20 63 68 61 72 61 63 74 65 72 73 2e 20 20 57 68 69 74 65 20 73 70 61 63 65 20 69 6e 20 74   ┆ll characters.  White space in t┆
0xe40…e60 6f 6b 65 6e 73 20 6f 72 0a 20 20 20 20 20 74 6f 6b 65 6e 2d 76 61 6c 75 65 20 70 61 69 72 73 20   ┆okens or      token-value pairs ┆
0xe60…e80 6d 75 73 74 20 62 65 20 70 72 6f 74 65 63 74 65 64 20 66 72 6f 6d 20 74 68 65 20 73 68 65 6c 6c   ┆must be protected from the shell┆
0xe80…ea0 20 62 79 0a 20 20 20 20 20 71 75 6f 74 65 73 2e 0a 0a 44 65 63 65 6d 62 65 72 20 31 39 39 30 20   ┆ by      quotes.  December 1990 ┆
0xea0…ec0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 58 20 50 72 6f   ┆                          TX Pro┆
0xec0…ee0 67 72 61 6d 6d 65 72 27 73 20 52 65 66 65 72 65 6e 63 65 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a   ┆grammer's Reference             ┆
0xee0…f00 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   ┆                                ┆
0xf00…f0b 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a 0a                                                                  ┆           ┆