home *** CD-ROM | disk | FTP | other *** search
| Unknown | 1997-07-17 | 72.3 KB |
open in: 
MacOS 8.1
|
Win98
|
DOS
view JSON data
|
view as text
This file was not able to be converted.
This format is not currently supported by dexvert.
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| file
| data
| default
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| a0 20 01 00 01 00 00 00 | 00 00 00 00 06 08 00 00 |. ......|........|
|00000010| 00 08 00 00 01 10 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000020| 00 10 00 00 02 18 00 00 | c8 00 00 00 00 00 00 00 |........|........|
|00000030| 07 3a c1 00 00 00 00 00 | 00 18 00 00 a5 7c 00 00 |.:......|.....|..|
|00000040| 43 30 9d 05 40 25 ff ff | 60 73 ff ff d8 3b 00 00 |C0..@%..|`s...;..|
|00000050| 16 00 00 00 b0 fc 07 00 | 00 00 00 00 07 3a c1 00 |........|.....:..|
|00000060| 07 3a c1 00 07 3a c1 00 | 00 00 00 00 70 65 72 6c |.:...:..|....perl|
|00000070| 78 73 20 2d 20 58 53 20 | 6c 61 6e 67 75 61 67 65 |xs - XS |language|
|00000080| 20 72 65 66 65 72 05 05 | 65 6e 63 65 20 6d 61 6e | refer..|ence man|
|00000090| 75 61 6c 0d 08 05 05 05 | 07 3a c1 00 00 00 00 00 |ual.....|.:......|
|000000a0| 07 00 50 13 08 1a a1 00 | 08 1a a1 00 00 00 00 00 |..P.....|........|
|000000b0| 05 00 00 00 00 7c 00 00 | a5 40 00 00 40 a2 5f 01 |.....|..|.@..@._.|
|000000c0| a0 98 fe ff f0 de fe ff | 68 37 00 00 44 65 73 63 |........|h7..Desc|
|000000d0| 72 69 70 74 69 6f 6e 0d | 08 65 73 63 08 1b a1 00 |ription.|.esc....|
|000000e0| 00 00 00 00 07 54 01 00 | 0a 1c a1 00 0a 1c a1 00 |.....T..|........|
|000000f0| 00 00 00 00 00 40 00 00 | a5 30 00 00 40 be 1d 01 |.....@..|.0..@...|
|00000100| 6f 38 fe ff 1f 6f fe ff | 18 2b 00 00 49 6e 74 72 |o8...o..|.+..Intr|
|00000110| 6f 64 75 63 74 69 6f 6e | 0d 08 00 00 0a 1d a1 00 |oduction|........|
|00000120| 00 00 00 00 00 30 00 00 | 05 84 00 00 00 ec ea 07 |.....0..|........|
|00000130| 3a e3 fd ff 1a 12 fe ff | 20 22 00 00 58 53 20 69 |:.......| "..XS i|
|00000140| 73 20 61 20 6c 61 6e 67 | 75 61 67 65 20 75 73 65 |s a lang|uage use|
|00000150| 64 20 74 6f 20 63 72 65 | 61 74 65 20 61 6e 20 65 |d to cre|ate an e|
|00000160| 78 74 65 6e 73 69 6f 6e | 20 69 6e 74 65 72 66 61 |xtension| interfa|
|00000170| 63 65 20 62 65 74 77 65 | 65 6e 20 50 65 72 6c 20 |ce betwe|en Perl |
|00000180| 61 6e 64 20 73 6f 6d 65 | 20 43 20 6c 69 62 72 61 |and some| C libra|
|00000190| 72 79 20 77 68 69 63 68 | 20 6f 6e 65 20 77 69 73 |ry which| one wis|
|000001a0| 68 65 73 20 74 6f 20 00 | 00 84 00 00 05 88 00 00 |hes to .|........|
|000001b0| 00 94 d6 07 13 ab fd ff | f3 d9 fd ff 20 22 00 00 |........|.... "..|
|000001c0| 75 73 65 20 77 69 74 68 | 20 50 65 72 6c 2e 20 20 |use with| Perl. |
|000001d0| 54 68 65 20 58 53 20 69 | 6e 74 65 72 66 61 63 65 |The XS i|nterface|
|000001e0| 20 69 73 20 63 6f 6d 62 | 69 6e 65 64 20 77 69 74 | is comb|ined wit|
|000001f0| 68 20 74 68 65 20 6c 69 | 62 72 61 72 79 20 74 6f |h the li|brary to|
|00000200| 20 63 72 65 61 74 65 20 | 61 20 6e 65 77 20 6c 69 | create |a new li|
|00000210| 62 72 61 72 79 20 77 68 | 69 63 68 20 63 61 6e 20 |brary wh|ich can |
|00000220| 62 65 20 6c 69 6e 6b 65 | 64 20 74 6f 20 00 00 00 |be linke|d to ...|
|00000230| 00 88 00 00 a5 a0 00 00 | 40 94 f1 07 ec 72 fd ff |........|@....r..|
|00000240| cc a1 fd ff 20 22 00 00 | 50 65 72 6c 2e 20 20 41 |.... "..|Perl. A|
|00000250| 6e 20 07 6f 10 1e a1 00 | 10 1e a1 00 00 00 00 00 |n .o....|........|
|00000260| 58 53 55 42 08 07 05 05 | 10 00 00 00 00 00 00 00 |XSUB....|........|
|00000270| 20 69 73 20 61 20 66 75 | 6e 63 74 69 6f 6e 20 69 | is a fu|nction i|
|00000280| 6e 20 74 68 65 20 58 53 | 20 6c 61 6e 67 75 61 67 |n the XS| languag|
|00000290| 65 20 61 6e 64 20 69 73 | 20 74 68 65 20 63 6f 72 |e and is| the cor|
|000002a0| 65 20 63 6f 6d 70 6f 6e | 65 6e 74 20 6f 66 20 74 |e compon|ent of t|
|000002b0| 68 65 20 50 65 72 6c 20 | 61 70 70 6c 69 63 61 74 |he Perl |applicat|
|000002c0| 69 6f 6e 20 69 6e 74 65 | 72 66 61 63 65 2e 0d 00 |ion inte|rface...|
|000002d0| 00 a0 00 00 85 98 00 00 | 00 70 94 07 15 04 fd ff |........|.p......|
|000002e0| f5 32 fd ff 20 22 00 00 | 54 68 65 20 58 53 20 63 |.2.. "..|The XS c|
|000002f0| 6f 6d 70 69 6c 65 72 20 | 69 73 20 63 61 6c 6c 65 |ompiler |is calle|
|00000300| 64 20 07 76 10 1f a1 00 | 10 1f a1 00 00 00 00 00 |d .v....|........|
|00000310| 78 73 75 62 70 70 08 68 | 10 00 00 00 00 00 00 00 |xsubpp.h|........|
|00000320| 2e 20 20 54 68 69 73 20 | 63 6f 6d 70 69 6c 65 72 |. This |compiler|
|00000330| 20 77 69 6c 6c 20 65 6d | 62 65 64 20 74 68 65 20 | will em|bed the |
|00000340| 63 6f 6e 73 74 72 75 63 | 74 73 20 6e 65 63 65 73 |construc|ts neces|
|00000350| 73 61 72 79 20 74 6f 20 | 6c 65 74 20 61 6e 20 58 |sary to |let an X|
|00000360| 53 55 42 2c 20 00 00 00 | 00 98 00 00 05 84 00 00 |SUB, ...|........|
|00000370| 00 20 a2 07 ee cb fc ff | ce fa fc ff 20 22 00 00 |. ......|.... "..|
|00000380| 77 68 69 63 68 20 69 73 | 20 72 65 61 6c 6c 79 20 |which is| really |
|00000390| 61 20 43 20 66 75 6e 63 | 74 69 6f 6e 20 69 6e 20 |a C func|tion in |
|000003a0| 64 69 73 67 75 69 73 65 | 2c 20 6d 61 6e 69 70 75 |disguise|, manipu|
|000003b0| 6c 61 74 65 20 50 65 72 | 6c 20 76 61 6c 75 65 73 |late Per|l values|
|000003c0| 20 61 6e 64 20 63 72 65 | 61 74 65 73 20 74 68 65 | and cre|ates the|
|000003d0| 20 67 6c 75 65 20 6e 65 | 63 65 73 73 61 72 79 20 | glue ne|cessary |
|000003e0| 74 6f 20 6c 65 74 20 50 | 65 72 6c 20 00 84 00 00 |to let P|erl ....|
|000003f0| 85 94 00 00 00 00 68 07 | c7 93 fc ff a7 c2 fc ff |......h.|........|
|00000400| 20 22 00 00 61 63 63 65 | 73 73 20 74 68 65 20 58 | "..acce|ss the X|
|00000410| 53 55 42 2e 20 20 54 68 | 65 20 63 6f 6d 70 69 6c |SUB. Th|e compil|
|00000420| 65 72 20 75 73 65 73 20 | 07 65 20 73 10 20 a1 00 |er uses |.e s. ..|
|00000430| 10 20 a1 00 00 00 00 00 | 74 79 70 65 6d 61 70 73 |. ......|typemaps|
|00000440| 08 20 74 79 10 00 00 00 | 00 00 00 00 20 74 6f 20 |. ty....|.... to |
|00000450| 64 65 74 65 72 6d 69 6e | 65 20 68 6f 77 20 74 6f |determin|e how to|
|00000460| 20 6d 61 70 20 43 20 66 | 75 6e 63 74 69 6f 6e 20 | map C f|unction |
|00000470| 70 61 72 61 6d 65 74 65 | 72 73 20 61 6e 64 20 00 |paramete|rs and .|
|00000480| 00 94 00 00 05 80 00 00 | 00 5c ea 07 a0 5b fc ff |........|.\...[..|
|00000490| 80 8a fc ff 20 22 00 00 | 76 61 72 69 61 62 6c 65 |.... "..|variable|
|000004a0| 73 20 74 6f 20 50 65 72 | 6c 20 76 61 6c 75 65 73 |s to Per|l values|
|000004b0| 2e 20 20 54 68 65 20 64 | 65 66 61 75 6c 74 20 74 |. The d|efault t|
|000004c0| 79 70 65 6d 61 70 20 68 | 61 6e 64 6c 65 73 20 6d |ypemap h|andles m|
|000004d0| 61 6e 79 20 63 6f 6d 6d | 6f 6e 20 43 20 74 79 70 |any comm|on C typ|
|000004e0| 65 73 2e 20 20 41 20 73 | 75 70 70 6c 65 6d 65 6e |es. A s|upplemen|
|000004f0| 74 20 74 79 70 65 6d 61 | 70 20 6d 75 73 74 20 00 |t typema|p must .|
|00000500| 00 80 00 00 25 68 00 00 | 40 ac 96 05 79 23 fc ff |....%h..|@...y#..|
|00000510| 59 52 fc ff 20 22 00 00 | 62 65 20 63 72 65 61 74 |YR.. "..|be creat|
|00000520| 65 64 20 74 6f 20 68 61 | 6e 64 6c 65 20 73 70 65 |ed to ha|ndle spe|
|00000530| 63 69 61 6c 20 73 74 72 | 75 63 74 75 72 65 73 20 |cial str|uctures |
|00000540| 61 6e 64 20 74 79 70 65 | 73 20 66 6f 72 20 74 68 |and type|s for th|
|00000550| 65 20 6c 69 62 72 61 72 | 79 20 62 65 69 6e 67 20 |e librar|y being |
|00000560| 6c 69 6e 6b 65 64 2e 0d | 00 68 00 00 a5 94 00 00 |linked..|.h......|
|00000570| 40 c8 d7 05 a2 b4 fb ff | 82 e3 fb ff 20 22 00 00 |@.......|.... "..|
|00000580| 53 65 65 20 74 68 65 20 | 63 68 61 70 74 65 72 20 |See the |chapter |
|00000590| 07 63 74 69 10 21 a1 00 | 10 21 a1 00 00 00 00 00 |.cti.!..|.!......|
|000005a0| 70 65 72 6c 78 73 74 75 | 74 08 61 74 10 00 00 00 |perlxstu|t.at....|
|000005b0| 00 00 00 00 20 66 6f 72 | 20 61 20 74 75 74 6f 72 |.... for| a tutor|
|000005c0| 69 61 6c 20 6f 6e 20 74 | 68 65 20 77 68 6f 6c 65 |ial on t|he whole|
|000005d0| 20 65 78 74 65 6e 73 69 | 6f 6e 20 63 72 65 61 74 | extensi|on creat|
|000005e0| 69 6f 6e 20 70 72 6f 63 | 65 73 73 2e 0d 07 65 72 |ion proc|ess...er|
|000005f0| 0a 22 a1 00 0a 22 a1 00 | 00 00 00 00 00 94 00 00 |."..."..|........|
|00000600| a5 30 00 00 40 4e 47 01 | fb 3d fb ff ab 74 fb ff |.0..@NG.|.=...t..|
|00000610| 18 2b 00 00 4f 6e 20 54 | 68 65 20 52 6f 61 64 0d |.+..On T|he Road.|
|00000620| 08 20 69 73 0a 23 a1 00 | 00 00 00 00 00 30 00 00 |. is.#..|.....0..|
|00000630| 05 80 00 00 00 50 c0 07 | c6 e8 fa ff a6 17 fb ff |.....P..|........|
|00000640| 20 22 00 00 4d 61 6e 79 | 20 6f 66 20 74 68 65 20 | "..Many| of the |
|00000650| 65 78 61 6d 70 6c 65 73 | 20 77 68 69 63 68 20 66 |examples| which f|
|00000660| 6f 6c 6c 6f 77 20 77 69 | 6c 6c 20 63 6f 6e 63 65 |ollow wi|ll conce|
|00000670| 6e 74 72 61 74 65 20 6f | 6e 20 63 72 65 61 74 69 |ntrate o|n creati|
|00000680| 6e 67 20 61 6e 20 69 6e | 74 65 72 66 61 63 65 20 |ng an in|terface |
|00000690| 62 65 74 77 65 65 6e 20 | 50 65 72 6c 20 61 6e 64 |between |Perl and|
|000006a0| 20 74 68 65 20 4f 4e 43 | 2b 20 00 00 00 80 00 00 | the ONC|+ ......|
|000006b0| 05 80 00 00 00 fc b0 07 | 9f b0 fa ff 7f df fa ff |........|........|
|000006c0| 20 22 00 00 52 50 43 20 | 62 69 6e 64 20 6c 69 62 | "..RPC |bind lib|
|000006d0| 72 61 72 79 20 66 75 6e | 63 74 69 6f 6e 73 2e 20 |rary fun|ctions. |
|000006e0| 20 54 68 65 20 72 70 63 | 62 5f 67 65 74 74 69 6d | The rpc|b_gettim|
|000006f0| 65 28 29 20 66 75 6e 63 | 74 69 6f 6e 20 69 73 20 |e() func|tion is |
|00000700| 75 73 65 64 20 74 6f 20 | 64 65 6d 6f 6e 73 74 72 |used to |demonstr|
|00000710| 61 74 65 20 6d 61 6e 79 | 20 66 65 61 74 75 72 65 |ate many| feature|
|00000720| 73 20 6f 66 20 74 68 65 | 20 58 53 20 00 80 00 00 |s of the| XS ....|
|00000730| 05 84 00 00 00 a4 84 07 | 78 78 fa ff 58 a7 fa ff |........|xx..X...|
|00000740| 20 22 00 00 6c 61 6e 67 | 75 61 67 65 2e 20 20 54 | "..lang|uage. T|
|00000750| 68 69 73 20 66 75 6e 63 | 74 69 6f 6e 20 68 61 73 |his func|tion has|
|00000760| 20 74 77 6f 20 70 61 72 | 61 6d 65 74 65 72 73 3b | two par|ameters;|
|00000770| 20 74 68 65 20 66 69 72 | 73 74 20 69 73 20 61 6e | the fir|st is an|
|00000780| 20 69 6e 70 75 74 20 70 | 61 72 61 6d 65 74 65 72 | input p|arameter|
|00000790| 20 61 6e 64 20 74 68 65 | 20 73 65 63 6f 6e 64 20 | and the| second |
|000007a0| 69 73 20 61 6e 20 6f 75 | 74 70 75 74 20 00 00 00 |is an ou|tput ...|
|000007b0| 00 84 00 00 a5 70 00 00 | 40 1c c5 03 51 40 fa ff |.....p..|@...Q@..|
|000007c0| 31 6f fa ff 20 22 00 00 | 70 61 72 61 6d 65 74 65 |1o.. "..|paramete|
|000007d0| 72 2e 20 20 54 68 65 20 | 66 75 6e 63 74 69 6f 6e |r. The |function|
|000007e0| 20 61 6c 73 6f 20 72 65 | 74 75 72 6e 73 20 61 20 | also re|turns a |
|000007f0| 73 74 61 74 75 73 20 76 | 61 6c 75 65 2e 0d 07 72 |status v|alue...r|
|00000800| 12 24 a1 00 12 24 a1 00 | 00 00 00 00 07 72 20 61 |.$...$..|.....r a|
|00000810| 0c 25 a1 00 12 24 a1 00 | 0c 25 a1 00 00 00 00 00 |.%...$..|.%......|
|00000820| 00 70 00 00 a5 78 00 00 | 40 30 da 04 4a d9 f9 ff |.p...x..|@0..J...|
|00000830| 5a 00 fa ff 70 1a 00 00 | 62 6f 6f 6c 5f 74 20 72 |Z...p...|bool_t r|
|00000840| 70 63 62 5f 67 65 74 74 | 69 6d 65 28 63 6f 6e 73 |pcb_gett|ime(cons|
|00000850| 74 20 63 68 61 72 20 2a | 68 6f 73 74 2c 20 74 69 |t char *|host, ti|
|00000860| 6d 65 5f 74 20 2a 74 69 | 6d 65 70 29 3b 0d 08 74 |me_t *ti|mep);..t|
|00000870| 0c 26 a1 00 12 24 a1 00 | 00 00 00 00 08 63 6f 64 |.&...$..|.....cod|
|00000880| 12 00 00 00 00 00 00 00 | 07 74 61 74 18 27 a1 00 |........|.tat.'..|
|00000890| 18 27 a1 00 00 00 00 00 | 00 78 00 00 a5 24 00 00 |.'......|.x...$..|
|000008a0| 40 00 00 00 ba c4 f9 ff | 7a d1 f9 ff 00 00 00 00 |@.......|z.......|
|000008b0| 0d 08 68 65 18 28 a1 00 | 00 00 00 00 00 24 00 00 |..he.(..|.....$..|
|000008c0| a5 7c 00 00 40 ac d3 04 | ea 6b f9 ff ca 9a f9 ff |.|..@...|.k......|
|000008d0| 20 22 00 00 46 72 6f 6d | 20 43 20 74 68 69 73 20 | "..From| C this |
|000008e0| 66 75 6e 63 74 69 6f 6e | 20 77 69 6c 6c 20 62 65 |function| will be|
|000008f0| 20 63 61 6c 6c 65 64 20 | 77 69 74 68 20 74 68 65 | called |with the|
|00000900| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 73 74 61 74 65 | followi|ng state|
|00000910| 6d 65 6e 74 73 2e 0d 07 | 12 29 a1 00 12 29 a1 00 |ments...|.)...)..|
|00000920| 00 00 00 00 07 29 3b 0d | 0c 2a a1 00 12 29 a1 00 |.....);.|.*...)..|
|00000930| 0c 2a a1 00 00 00 00 00 | 00 7c 00 00 25 30 00 00 |.*......|.|..%0..|
|00000940| 40 c0 d4 01 e3 04 f9 ff | f3 2b f9 ff 70 1a 00 00 |@.......|.+..p...|
|00000950| 23 69 6e 63 6c 75 64 65 | 20 3c 72 70 63 2f 72 70 |#include| <rpc/rp|
|00000960| 63 2e 68 3e 0d 00 00 00 | 00 30 00 00 25 28 00 00 |c.h>....|.0..%(..|
|00000970| 40 20 48 01 03 d6 f8 ff | 13 fd f8 ff 70 1a 00 00 |@ H.....|....p...|
|00000980| 62 6f 6f 6c 5f 74 20 73 | 74 61 74 75 73 3b 0d 00 |bool_t s|tatus;..|
|00000990| 00 28 00 00 25 28 00 00 | 40 b0 30 01 23 a7 f8 ff |.(..%(..|@.0.#...|
|000009a0| 33 ce f8 ff 70 1a 00 00 | 74 69 6d 65 5f 74 20 74 |3...p...|time_t t|
|000009b0| 69 6d 65 70 3b 0d 00 00 | 00 28 00 00 a5 70 00 00 |imep;...|.(...p..|
|000009c0| 40 b0 1e 04 43 78 f8 ff | 53 9f f8 ff 70 1a 00 00 |@...Cx..|S...p...|
|000009d0| 73 74 61 74 75 73 20 3d | 20 72 70 63 62 5f 67 65 |status =| rpcb_ge|
|000009e0| 74 74 69 6d 65 28 20 22 | 6c 6f 63 61 6c 68 6f 73 |ttime( "|localhos|
|000009f0| 74 22 2c 20 26 74 69 6d | 65 70 20 29 3b 0d 08 20 |t", &tim|ep );.. |
|00000a00| 0c 2b a1 00 12 29 a1 00 | 00 00 00 00 08 65 74 77 |.+...)..|.....etw|
|00000a10| 12 00 00 00 00 00 00 00 | 07 20 50 65 18 2c a1 00 |........|. Pe.,..|
|00000a20| 18 2c a1 00 00 00 00 00 | 00 70 00 00 a5 24 00 00 |.,......|.p...$..|
|00000a30| 40 00 00 00 b3 63 f8 ff | 73 70 f8 ff 00 00 00 00 |@....c..|sp......|
|00000a40| 0d 08 20 66 18 2d a1 00 | 00 00 00 00 00 24 00 00 |.. f.-..|.....$..|
|00000a50| 05 84 00 00 00 a0 af 07 | e3 0a f8 ff c3 39 f8 ff |........|.....9..|
|00000a60| 20 22 00 00 49 66 20 61 | 6e 20 58 53 55 42 20 69 | "..If a|n XSUB i|
|00000a70| 73 20 63 72 65 61 74 65 | 64 20 74 6f 20 6f 66 66 |s create|d to off|
|00000a80| 65 72 20 61 20 64 69 72 | 65 63 74 20 74 72 61 6e |er a dir|ect tran|
|00000a90| 73 6c 61 74 69 6f 6e 20 | 62 65 74 77 65 65 6e 20 |slation |between |
|00000aa0| 74 68 69 73 20 66 75 6e | 63 74 69 6f 6e 20 61 6e |this fun|ction an|
|00000ab0| 64 20 50 65 72 6c 2c 20 | 74 68 65 6e 20 74 68 69 |d Perl, |then thi|
|00000ac0| 73 20 58 53 55 42 20 77 | 69 6c 6c 20 62 65 20 00 |s XSUB w|ill be .|
|00000ad0| 00 84 00 00 05 80 00 00 | 00 ac 88 07 bc d2 f7 ff |........|........|
|00000ae0| 9c 01 f8 ff 20 22 00 00 | 75 73 65 64 20 66 72 6f |.... "..|used fro|
|00000af0| 6d 20 50 65 72 6c 20 77 | 69 74 68 20 74 68 65 20 |m Perl w|ith the |
|00000b00| 66 6f 6c 6c 6f 77 69 6e | 67 20 63 6f 64 65 2e 20 |followin|g code. |
|00000b10| 54 68 65 20 24 73 74 61 | 74 75 73 20 61 6e 64 20 |The $sta|tus and |
|00000b20| 24 74 69 6d 65 70 20 76 | 61 72 69 61 62 6c 65 73 |$timep v|ariables|
|00000b30| 20 77 69 6c 6c 20 63 6f | 6e 74 61 69 6e 20 74 68 | will co|ntain th|
|00000b40| 65 20 6f 75 74 70 75 74 | 20 6f 66 20 74 68 65 20 |e output| of the |
|00000b50| 00 80 00 00 a5 44 00 00 | 40 f4 a7 00 95 9a f7 ff |.....D..|@.......|
|00000b60| 75 c9 f7 ff 20 22 00 00 | 66 75 6e 63 74 69 6f 6e |u... "..|function|
|00000b70| 2e 05 0d 07 12 2e a1 00 | 12 2e a1 00 00 00 00 00 |........|........|
|00000b80| 07 65 20 65 0c 2f a1 00 | 12 2e a1 00 0c 2f a1 00 |.e e./..|...../..|
|00000b90| 00 00 00 00 00 44 00 00 | 25 24 00 00 40 80 bb 00 |.....D..|%$..@...|
|00000ba0| 8e 33 f7 ff 9e 5a f7 ff | 70 1a 00 00 75 73 65 20 |.3...Z..|p...use |
|00000bb0| 52 50 43 3b 0d 00 00 00 | 00 24 00 00 a5 70 00 00 |RPC;....|.$...p..|
|00000bc0| 40 20 36 04 ae 04 f7 ff | be 2b f7 ff 70 1a 00 00 |@ 6.....|.+..p...|
|00000bd0| 24 73 74 61 74 75 73 20 | 3d 20 72 70 63 62 5f 67 |$status |= rpcb_g|
|00000be0| 65 74 74 69 6d 65 28 20 | 22 6c 6f 63 61 6c 68 6f |ettime( |"localho|
|00000bf0| 73 74 22 2c 20 24 74 69 | 6d 65 70 20 29 3b 0d 08 |st", $ti|mep );..|
|00000c00| 0c 30 a1 00 12 2e a1 00 | 00 00 00 00 08 2f 72 70 |.0......|...../rp|
|00000c10| 12 00 00 00 00 00 00 00 | 07 3b a1 00 18 31 a1 00 |........|.;...1..|
|00000c20| 18 31 a1 00 00 00 00 00 | 00 70 00 00 a5 24 00 00 |.1......|.p...$..|
|00000c30| 40 00 00 00 1e f0 f6 ff | de fc f6 ff 00 00 00 00 |@.......|........|
|00000c40| 0d 08 05 05 18 32 a1 00 | 00 00 00 00 00 24 00 00 |.....2..|.....$..|
|00000c50| 05 80 00 00 00 d0 dc 07 | 4e 97 f6 ff 2e c6 f6 ff |........|N.......|
|00000c60| 20 22 00 00 54 68 65 20 | 66 6f 6c 6c 6f 77 69 6e | "..The |followin|
|00000c70| 67 20 58 53 20 66 69 6c | 65 20 73 68 6f 77 73 20 |g XS fil|e shows |
|00000c80| 61 6e 20 58 53 20 73 75 | 62 72 6f 75 74 69 6e 65 |an XS su|broutine|
|00000c90| 2c 20 6f 72 20 58 53 55 | 42 2c 20 77 68 69 63 68 |, or XSU|B, which|
|00000ca0| 20 64 65 6d 6f 6e 73 74 | 72 61 74 65 73 20 6f 6e | demonst|rates on|
|00000cb0| 65 20 70 6f 73 73 69 62 | 6c 65 20 69 6e 74 65 72 |e possib|le inter|
|00000cc0| 66 61 63 65 20 74 6f 20 | 74 68 65 20 00 80 00 00 |face to |the ....|
|00000cd0| 05 84 00 00 00 54 ef 07 | 27 5f f6 ff 07 8e f6 ff |.....T..|'_......|
|00000ce0| 20 22 00 00 72 70 63 62 | 5f 67 65 74 74 69 6d 65 | "..rpcb|_gettime|
|00000cf0| 28 29 20 66 75 6e 63 74 | 69 6f 6e 2e 20 20 54 68 |() funct|ion. Th|
|00000d00| 69 73 20 58 53 55 42 20 | 72 65 70 72 65 73 65 6e |is XSUB |represen|
|00000d10| 74 73 20 61 20 64 69 72 | 65 63 74 20 74 72 61 6e |ts a dir|ect tran|
|00000d20| 73 6c 61 74 69 6f 6e 20 | 62 65 74 77 65 65 6e 20 |slation |between |
|00000d30| 43 20 61 6e 64 20 50 65 | 72 6c 20 61 6e 64 20 73 |C and Pe|rl and s|
|00000d40| 6f 20 70 72 65 73 65 72 | 76 65 73 20 74 68 65 20 |o preser|ves the |
|00000d50| 00 84 00 00 05 84 00 00 | 00 fc d7 07 00 27 f6 ff |........|.....'..|
|00000d60| e0 55 f6 ff 20 22 00 00 | 69 6e 74 65 72 66 61 63 |.U.. "..|interfac|
|00000d70| 65 20 65 76 65 6e 20 66 | 72 6f 6d 20 50 65 72 6c |e even f|rom Perl|
|00000d80| 2e 20 54 68 69 73 20 58 | 53 55 42 20 77 69 6c 6c |. This X|SUB will|
|00000d90| 20 62 65 20 69 6e 76 6f | 6b 65 64 20 66 72 6f 6d | be invo|ked from|
|00000da0| 20 50 65 72 6c 20 77 69 | 74 68 20 74 68 65 20 75 | Perl wi|th the u|
|00000db0| 73 61 67 65 20 73 68 6f | 77 6e 20 61 62 6f 76 65 |sage sho|wn above|
|00000dc0| 2e 20 20 4e 6f 74 65 20 | 74 68 61 74 20 74 68 65 |. Note |that the|
|00000dd0| 20 00 00 00 00 84 00 00 | 85 c4 00 00 00 34 6a 07 | .......|.....4j.|
|00000de0| d9 ee f5 ff b9 1d f6 ff | 20 22 00 00 66 69 72 73 |........| "..firs|
|00000df0| 74 20 74 68 72 65 65 20 | 23 69 6e 63 6c 75 64 65 |t three |#include|
|00000e00| 20 73 74 61 74 65 6d 65 | 6e 74 73 2c 20 66 6f 72 | stateme|nts, for|
|00000e10| 20 07 64 75 0e 33 a1 00 | 0e 33 a1 00 00 00 00 00 | .du.3..|.3......|
|00000e20| 45 58 54 45 52 4e 2e 68 | 08 74 65 6e 0e 34 a1 00 |EXTERN.h|.ten.4..|
|00000e30| 00 00 00 00 2c 20 07 74 | 0e 35 a1 00 0e 35 a1 00 |...., .t|.5...5..|
|00000e40| 00 00 00 00 70 65 72 6c | 2e 68 08 74 0e 36 a1 00 |....perl|.h.t.6..|
|00000e50| 00 00 00 00 2c 20 61 6e | 64 20 07 72 0e 37 a1 00 |...., an|d .r.7..|
|00000e60| 0e 37 a1 00 00 00 00 00 | 58 53 55 42 2e 68 08 68 |.7......|XSUB.h.h|
|00000e70| 0e 38 a1 00 00 00 00 00 | 2c 20 77 69 6c 6c 20 61 |.8......|, will a|
|00000e80| 6c 77 61 79 73 20 62 65 | 20 70 72 65 73 65 6e 74 |lways be| present|
|00000e90| 20 61 74 20 74 68 65 20 | 00 c4 00 00 a5 98 00 00 | at the |........|
|00000ea0| 40 dc ad 06 b2 b6 f5 ff | 92 e5 f5 ff 20 22 00 00 |@.......|.... "..|
|00000eb0| 62 65 67 69 6e 6e 69 6e | 67 20 6f 66 20 61 6e 20 |beginnin|g of an |
|00000ec0| 58 53 20 66 69 6c 65 2e | 20 20 54 68 69 73 20 61 |XS file.| This a|
|00000ed0| 70 70 72 6f 61 63 68 20 | 61 6e 64 20 6f 74 68 65 |pproach |and othe|
|00000ee0| 72 73 20 77 69 6c 6c 20 | 62 65 20 65 78 70 61 6e |rs will |be expan|
|00000ef0| 64 65 64 20 6c 61 74 65 | 72 20 69 6e 20 74 68 69 |ded late|r in thi|
|00000f00| 73 20 64 6f 63 75 6d 65 | 6e 74 2e 0d 07 20 07 05 |s docume|nt... ..|
|00000f10| 12 39 a1 00 12 39 a1 00 | 00 00 00 00 07 73 65 08 |.9...9..|.....se.|
|00000f20| 0c 3a a1 00 12 39 a1 00 | 0c 3a a1 00 00 00 00 00 |.:...9..|.:......|
|00000f30| 00 98 00 00 25 2c 00 00 | 40 50 bd 01 ab 4f f5 ff |....%,..|@P...O..|
|00000f40| bb 76 f5 ff 70 1a 00 00 | 23 69 6e 63 6c 75 64 65 |.v..p...|#include|
|00000f50| 20 22 45 58 54 45 52 4e | 2e 68 22 0d 00 2c 00 00 | "EXTERN|.h"..,..|
|00000f60| 25 2c 00 00 40 70 8e 01 | cb 20 f5 ff db 47 f5 ff |%,..@p..|. ...G..|
|00000f70| 70 1a 00 00 23 69 6e 63 | 6c 75 64 65 20 22 70 65 |p...#inc|lude "pe|
|00000f80| 72 6c 2e 68 22 0d 00 00 | 00 2c 00 00 25 2c 00 00 |rl.h"...|.,..%,..|
|00000f90| 40 70 8e 01 eb f1 f4 ff | fb 18 f5 ff 70 1a 00 00 |@p......|....p...|
|00000fa0| 23 69 6e 63 6c 75 64 65 | 20 22 58 53 55 42 2e 68 |#include| "XSUB.h|
|00000fb0| 22 0d 00 00 00 2c 00 00 | a5 58 00 00 40 c0 d4 01 |"....,..|.X..@...|
|00000fc0| 0b c3 f4 ff 1b ea f4 ff | 70 1a 00 00 23 69 6e 63 |........|p...#inc|
|00000fd0| 6c 75 64 65 20 3c 72 70 | 63 2f 72 70 63 2e 68 3e |lude <rp|c/rpc.h>|
|00000fe0| 0d 08 05 05 0c 3b a1 00 | 12 39 a1 00 00 00 00 00 |.....;..|.9......|
|00000ff0| 08 4f a1 00 12 00 00 00 | 00 00 00 00 07 05 05 05 |.O......|........|
|00001000| 18 3c a1 00 18 3c a1 00 | 00 00 00 00 00 58 00 00 |.<...<..|.....X..|
|00001010| a5 48 00 00 40 00 00 00 | 7b ae f4 ff 3b bb f4 ff |.H..@...|{...;...|
|00001020| 00 00 00 00 0d 08 69 72 | 18 3d a1 00 00 00 00 00 |......ir|.=......|
|00001030| 07 64 65 72 12 3e a1 00 | 12 3e a1 00 00 00 00 00 |.der.>..|.>......|
|00001040| 07 78 70 6f 0c 3f a1 00 | 12 3e a1 00 0c 3f a1 00 |.xpo.?..|.>...?..|
|00001050| 00 00 00 00 00 48 00 00 | a5 60 00 00 40 d0 78 02 |.....H..|.`..@.x.|
|00001060| 7b 5d f4 ff 8b 84 f4 ff | 70 1a 00 00 4d 4f 44 55 |{]......|p...MODU|
|00001070| 4c 45 20 3d 20 52 50 43 | 20 20 50 41 43 4b 41 47 |LE = RPC| PACKAG|
|00001080| 45 20 3d 20 52 50 43 0d | 08 00 00 00 0c 40 a1 00 |E = RPC.|.....@..|
|00001090| 12 3e a1 00 00 00 00 00 | 08 52 a1 00 12 00 00 00 |.>......|.R......|
|000010a0| 00 00 00 00 07 53 a1 00 | 18 41 a1 00 18 41 a1 00 |.....S..|.A...A..|
|000010b0| 00 00 00 00 00 60 00 00 | a5 48 00 00 40 00 00 00 |.....`..|.H..@...|
|000010c0| eb 48 f4 ff ab 55 f4 ff | 00 00 00 00 0d 08 00 00 |.H...U..|........|
|000010d0| 18 42 a1 00 00 00 00 00 | 07 3c a1 00 12 43 a1 00 |.B......|.<...C..|
|000010e0| 12 43 a1 00 00 00 00 00 | 07 48 00 00 0c 44 a1 00 |.C......|.H...D..|
|000010f0| 12 43 a1 00 0c 44 a1 00 | 00 00 00 00 00 48 00 00 |.C...D..|.....H..|
|00001100| 01 10 00 00 41 a0 8c 00 | 00 00 00 00 00 10 00 00 |....A...|........|
|00001110| 02 1c 00 00 64 02 00 00 | 00 00 00 00 12 43 a1 00 |....d...|.....C..|
|00001120| 0c 44 a1 00 00 00 00 00 | 00 1c 00 00 25 2c 00 00 |.D......|....%,..|
|00001130| 40 a0 8c 00 9f 4c f2 ff | af 73 f2 ff 70 1a 00 00 |@....L..|.s..p...|
|00001140| 16 00 00 00 b0 fc 07 00 | 00 00 00 00 62 6f 6f 6c |........|....bool|
|00001150| 5f 74 0d 00 00 2c 00 00 | 25 34 00 00 40 80 32 02 |_t...,..|%4..@.2.|
|00001160| bf 1d f2 ff cf 44 f2 ff | 70 1a 00 00 72 70 63 62 |.....D..|p...rpcb|
|00001170| 5f 67 65 74 74 69 6d 65 | 28 68 6f 73 74 2c 74 69 |_gettime|(host,ti|
|00001180| 6d 65 70 29 0d 00 00 00 | 00 34 00 00 25 28 00 00 |mep)....|.4..%(..|
|00001190| 40 90 5f 01 df ee f1 ff | ef 15 f2 ff 70 1a 00 00 |@._.....|....p...|
|000011a0| 20 20 20 20 20 63 68 61 | 72 20 2a 68 6f 73 74 0d | cha|r *host.|
|000011b0| 00 28 00 00 25 2c 00 00 | 40 e0 a5 01 ff bf f1 ff |.(..%,..|@.......|
|000011c0| 0f e7 f1 ff 70 1a 00 00 | 20 20 20 20 20 74 69 6d |....p...| tim|
|000011d0| 65 5f 74 20 26 74 69 6d | 65 70 0d 00 00 2c 00 00 |e_t &tim|ep...,..|
|000011e0| 25 28 00 00 40 40 19 01 | 1f 91 f1 ff 2f b8 f1 ff |%(..@@..|..../...|
|000011f0| 70 1a 00 00 20 20 20 20 | 20 4f 55 54 50 55 54 3a |p... | OUTPUT:|
|00001200| 0d 00 00 00 00 28 00 00 | a5 4c 00 00 40 60 ea 00 |.....(..|.L..@`..|
|00001210| 3f 62 f1 ff 4f 89 f1 ff | 70 1a 00 00 20 20 20 20 |?b..O...|p... |
|00001220| 20 74 69 6d 65 70 0d 08 | 0c 45 a1 00 12 43 a1 00 | timep..|.E...C..|
|00001230| 00 00 00 00 08 63 74 69 | 12 00 00 00 00 00 00 00 |.....cti|........|
|00001240| 07 68 65 20 18 46 a1 00 | 18 46 a1 00 00 00 00 00 |.he .F..|.F......|
|00001250| 00 4c 00 00 a5 24 00 00 | 40 00 00 00 af 4d f1 ff |.L...$..|@....M..|
|00001260| 6f 5a f1 ff 00 00 00 00 | 0d 08 72 70 18 47 a1 00 |oZ......|..rp.G..|
|00001270| 00 00 00 00 00 24 00 00 | 05 7c 00 00 00 b0 5a 07 |.....$..|.|....Z.|
|00001280| df f4 f0 ff bf 23 f1 ff | 20 22 00 00 41 6e 79 20 |.....#..| "..Any |
|00001290| 65 78 74 65 6e 73 69 6f | 6e 20 74 6f 20 50 65 72 |extensio|n to Per|
|000012a0| 6c 2c 20 69 6e 63 6c 75 | 64 69 6e 67 20 74 68 6f |l, inclu|ding tho|
|000012b0| 73 65 20 63 6f 6e 74 61 | 69 6e 69 6e 67 20 58 53 |se conta|ining XS|
|000012c0| 55 42 73 2c 20 73 68 6f | 75 6c 64 20 68 61 76 65 |UBs, sho|uld have|
|000012d0| 20 61 20 50 65 72 6c 20 | 6d 6f 64 75 6c 65 20 74 | a Perl |module t|
|000012e0| 6f 20 73 65 72 76 65 20 | 61 73 20 74 68 65 20 00 |o serve |as the .|
|000012f0| 00 7c 00 00 05 80 00 00 | 00 b8 52 07 b8 bc f0 ff |.|......|..R.....|
|00001300| 98 eb f0 ff 20 22 00 00 | 62 6f 6f 74 73 74 72 61 |.... "..|bootstra|
|00001310| 70 20 77 68 69 63 68 20 | 70 75 6c 6c 73 20 74 68 |p which |pulls th|
|00001320| 65 20 65 78 74 65 6e 73 | 69 6f 6e 20 69 6e 74 6f |e extens|ion into|
|00001330| 20 50 65 72 6c 2e 20 20 | 54 68 69 73 20 6d 6f 64 | Perl. |This mod|
|00001340| 75 6c 65 20 77 69 6c 6c | 20 65 78 70 6f 72 74 20 |ule will| export |
|00001350| 74 68 65 20 65 78 74 65 | 6e 73 69 6f 6e 27 73 20 |the exte|nsion's |
|00001360| 66 75 6e 63 74 69 6f 6e | 73 20 61 6e 64 20 00 00 |function|s and ..|
|00001370| 00 80 00 00 05 84 00 00 | 00 8c a8 07 91 84 f0 ff |........|........|
|00001380| 71 b3 f0 ff 20 22 00 00 | 76 61 72 69 61 62 6c 65 |q... "..|variable|
|00001390| 73 20 74 6f 20 74 68 65 | 20 50 65 72 6c 20 70 72 |s to the| Perl pr|
|000013a0| 6f 67 72 61 6d 20 61 6e | 64 20 77 69 6c 6c 20 63 |ogram an|d will c|
|000013b0| 61 75 73 65 20 74 68 65 | 20 65 78 74 65 6e 73 69 |ause the| extensi|
|000013c0| 6f 6e 27 73 20 58 53 55 | 42 73 20 74 6f 20 62 65 |on's XSU|Bs to be|
|000013d0| 20 6c 69 6e 6b 65 64 20 | 69 6e 74 6f 20 50 65 72 | linked |into Per|
|000013e0| 6c 2e 20 54 68 65 20 66 | 6f 6c 6c 6f 77 69 6e 67 |l. The f|ollowing|
|000013f0| 20 00 00 00 00 84 00 00 | 85 9c 00 00 00 e8 d0 07 | .......|........|
|00001400| 6a 4c f0 ff 4a 7b f0 ff | 20 22 00 00 6d 6f 64 75 |jL..J{..| "..modu|
|00001410| 6c 65 20 77 69 6c 6c 20 | 62 65 20 75 73 65 64 20 |le will |be used |
|00001420| 66 6f 72 20 6d 6f 73 74 | 20 6f 66 20 74 68 65 20 |for most| of the |
|00001430| 65 78 61 6d 70 6c 65 73 | 20 69 6e 20 74 68 69 73 |examples| in this|
|00001440| 20 64 6f 63 75 6d 65 6e | 74 20 61 6e 64 20 73 68 | documen|t and sh|
|00001450| 6f 75 6c 64 20 62 65 20 | 75 73 65 64 20 66 72 6f |ould be |used fro|
|00001460| 6d 20 50 65 72 6c 20 77 | 69 74 68 20 74 68 65 20 |m Perl w|ith the |
|00001470| 07 70 6f 69 0e 48 a1 00 | 0e 48 a1 00 00 00 00 00 |.poi.H..|.H......|
|00001480| 75 73 65 08 0e 49 a1 00 | 00 00 00 00 20 00 00 00 |use..I..|.... ...|
|00001490| 00 9c 00 00 a5 98 00 00 | 40 dc d1 06 43 14 f0 ff |........|@...C...|
|000014a0| 23 43 f0 ff 20 22 00 00 | 63 6f 6d 6d 61 6e 64 20 |#C.. "..|command |
|000014b0| 61 73 20 73 68 6f 77 6e | 20 65 61 72 6c 69 65 72 |as shown| earlier|
|000014c0| 2e 20 20 50 65 72 6c 20 | 6d 6f 64 75 6c 65 73 20 |. Perl |modules |
|000014d0| 61 72 65 20 65 78 70 6c | 61 69 6e 65 64 20 69 6e |are expl|ained in|
|000014e0| 20 6d 6f 72 65 20 64 65 | 74 61 69 6c 20 6c 61 74 | more de|tail lat|
|000014f0| 65 72 20 69 6e 20 74 68 | 69 73 20 64 6f 63 75 6d |er in th|is docum|
|00001500| 65 6e 74 2e 0d 07 00 00 | 12 4a a1 00 12 4a a1 00 |ent.....|.J...J..|
|00001510| 00 00 00 00 07 6e 73 69 | 0c 4b a1 00 12 4a a1 00 |.....nsi|.K...J..|
|00001520| 0c 4b a1 00 00 00 00 00 | 00 98 00 00 a5 50 00 00 |.K......|.....P..|
|00001530| 40 40 19 01 3c ad ef ff | 4c d4 ef ff 70 1a 00 00 |@@..<...|L...p...|
|00001540| 70 61 63 6b 61 67 65 20 | 52 50 43 3b 0d 08 72 70 |package |RPC;..rp|
|00001550| 0c 4c a1 00 12 4a a1 00 | 00 00 00 00 08 66 75 6e |.L...J..|.....fun|
|00001560| 12 00 00 00 00 00 00 00 | 07 76 65 2e 18 4d a1 00 |........|.ve..M..|
|00001570| 18 4d a1 00 00 00 00 00 | 00 50 00 00 a5 48 00 00 |.M......|.P...H..|
|00001580| 40 00 00 00 ac 98 ef ff | 6c a5 ef ff 00 00 00 00 |@.......|l.......|
|00001590| 0d 08 20 61 18 4e a1 00 | 00 00 00 00 07 6c 69 6e |.. a.N..|.....lin|
|000015a0| 12 4f a1 00 12 4f a1 00 | 00 00 00 00 07 61 6e 64 |.O...O..|.....and|
|000015b0| 0c 50 a1 00 12 4f a1 00 | 0c 50 a1 00 00 00 00 00 |.P...O..|.P......|
|000015c0| 00 48 00 00 25 2c 00 00 | 40 70 8e 01 ac 47 ef ff |.H..%,..|@p...G..|
|000015d0| bc 6e ef ff 70 1a 00 00 | 72 65 71 75 69 72 65 20 |.n..p...|require |
|000015e0| 45 78 70 6f 72 74 65 72 | 3b 0d 00 00 00 2c 00 00 |Exporter|;....,..|
|000015f0| 25 2c 00 00 40 50 bd 01 | cc 18 ef ff dc 3f ef ff |%,..@P..|.....?..|
|00001600| 70 1a 00 00 72 65 71 75 | 69 72 65 20 44 79 6e 61 |p...requ|ire Dyna|
|00001610| 4c 6f 61 64 65 72 3b 0d | 00 2c 00 00 25 38 00 00 |Loader;.|.,..%8..|
|00001620| 40 90 d6 02 ec e9 ee ff | fc 10 ef ff 70 1a 00 00 |@.......|....p...|
|00001630| 40 49 53 41 20 3d 20 71 | 77 28 45 78 70 6f 72 74 |@ISA = q|w(Export|
|00001640| 65 72 20 44 79 6e 61 4c | 6f 61 64 65 72 29 3b 0d |er DynaL|oader);.|
|00001650| 00 38 00 00 a5 60 00 00 | 40 b0 a7 02 0c bb ee ff |.8...`..|@.......|
|00001660| 1c e2 ee ff 70 1a 00 00 | 40 45 58 50 4f 52 54 20 |....p...|@EXPORT |
|00001670| 3d 20 71 77 28 20 72 70 | 63 62 5f 67 65 74 74 69 |= qw( rp|cb_getti|
|00001680| 6d 65 20 29 3b 0d 08 00 | 0c 51 a1 00 12 4f a1 00 |me );...|.Q...O..|
|00001690| 00 00 00 00 08 00 00 00 | 12 00 00 00 00 00 00 00 |........|........|
|000016a0| 07 69 a1 00 18 52 a1 00 | 18 52 a1 00 00 00 00 00 |.i...R..|.R......|
|000016b0| 00 60 00 00 a5 48 00 00 | 40 00 00 00 7c a6 ee ff |.`...H..|@...|...|
|000016c0| 3c b3 ee ff 00 00 00 00 | 0d 08 20 20 18 53 a1 00 |<.......|.. .S..|
|000016d0| 00 00 00 00 07 20 20 20 | 12 54 a1 00 12 54 a1 00 |..... |.T...T..|
|000016e0| 00 00 00 00 07 20 64 6f | 0c 55 a1 00 12 54 a1 00 |..... do|.U...T..|
|000016f0| 0c 55 a1 00 00 00 00 00 | 00 48 00 00 25 28 00 00 |.U......|.H..%(..|
|00001700| 40 20 48 01 7c 55 ee ff | 8c 7c ee ff 70 1a 00 00 |@ H.|U..|.|..p...|
|00001710| 62 6f 6f 74 73 74 72 61 | 70 20 52 50 43 3b 0d 00 |bootstra|p RPC;..|
|00001720| 00 28 00 00 a5 44 00 00 | 40 e0 2e 00 9c 26 ee ff |.(...D..|@....&..|
|00001730| ac 4d ee ff 70 1a 00 00 | 31 3b 0d 08 0c 56 a1 00 |.M..p...|1;...V..|
|00001740| 12 54 a1 00 00 00 00 00 | 08 05 05 05 12 00 00 00 |.T......|........|
|00001750| 00 00 00 00 07 05 05 05 | 18 57 a1 00 18 57 a1 00 |........|.W...W..|
|00001760| 00 00 00 00 00 44 00 00 | a5 24 00 00 40 00 00 00 |.....D..|.$..@...|
|00001770| 0c 12 ee ff cc 1e ee ff | 00 00 00 00 0d 08 6f 64 |........|......od|
|00001780| 18 58 a1 00 00 00 00 00 | 00 24 00 00 05 7c 00 00 |.X......|.$...|..|
|00001790| 00 48 5c 07 3c b9 ed ff | 1c e8 ed ff 20 22 00 00 |.H\.<...|.... "..|
|000017a0| 54 68 72 6f 75 67 68 6f | 75 74 20 74 68 69 73 20 |Througho|ut this |
|000017b0| 64 6f 63 75 6d 65 6e 74 | 20 61 20 76 61 72 69 65 |document| a varie|
|000017c0| 74 79 20 6f 66 20 69 6e | 74 65 72 66 61 63 65 73 |ty of in|terfaces|
|000017d0| 20 74 6f 20 74 68 65 20 | 72 70 63 62 5f 67 65 74 | to the |rpcb_get|
|000017e0| 74 69 6d 65 28 29 20 58 | 53 55 42 20 77 69 6c 6c |time() X|SUB will|
|000017f0| 20 62 65 20 65 78 70 6c | 6f 72 65 64 2e 20 20 54 | be expl|ored. T|
|00001800| 68 65 20 00 00 7c 00 00 | 05 84 00 00 00 9c c8 07 |he ..|..|........|
|00001810| 15 81 ed ff f5 af ed ff | 20 22 00 00 58 53 55 42 |........| "..XSUB|
|00001820| 73 20 77 69 6c 6c 20 74 | 61 6b 65 20 74 68 65 69 |s will t|ake thei|
|00001830| 72 20 70 61 72 61 6d 65 | 74 65 72 73 20 69 6e 20 |r parame|ters in |
|00001840| 64 69 66 66 65 72 65 6e | 74 20 6f 72 64 65 72 73 |differen|t orders|
|00001850| 20 6f 72 20 77 69 6c 6c | 20 74 61 6b 65 20 64 69 | or will| take di|
|00001860| 66 66 65 72 65 6e 74 20 | 6e 75 6d 62 65 72 73 20 |fferent |numbers |
|00001870| 6f 66 20 70 61 72 61 6d | 65 74 65 72 73 2e 20 20 |of param|eters. |
|00001880| 49 6e 20 65 61 63 68 20 | 00 84 00 00 05 80 00 00 |In each |........|
|00001890| 00 48 c5 07 ee 48 ed ff | ce 77 ed ff 20 22 00 00 |.H...H..|.w.. "..|
|000018a0| 63 61 73 65 20 74 68 65 | 20 58 53 55 42 20 69 73 |case the| XSUB is|
|000018b0| 20 61 6e 20 61 62 73 74 | 72 61 63 74 69 6f 6e 20 | an abst|raction |
|000018c0| 62 65 74 77 65 65 6e 20 | 50 65 72 6c 20 61 6e 64 |between |Perl and|
|000018d0| 20 74 68 65 20 72 65 61 | 6c 20 43 20 72 70 63 62 | the rea|l C rpcb|
|000018e0| 5f 67 65 74 74 69 6d 65 | 28 29 20 66 75 6e 63 74 |_gettime|() funct|
|000018f0| 69 6f 6e 2c 20 61 6e 64 | 20 74 68 65 20 58 53 55 |ion, and| the XSU|
|00001900| 42 20 6d 75 73 74 20 00 | 00 80 00 00 05 88 00 00 |B must .|........|
|00001910| 00 78 bc 07 c7 10 ed ff | a7 3f ed ff 20 22 00 00 |.x......|.?.. "..|
|00001920| 61 6c 77 61 79 73 20 65 | 6e 73 75 72 65 20 74 68 |always e|nsure th|
|00001930| 61 74 20 74 68 65 20 72 | 65 61 6c 20 72 70 63 62 |at the r|eal rpcb|
|00001940| 5f 67 65 74 74 69 6d 65 | 28 29 20 66 75 6e 63 74 |_gettime|() funct|
|00001950| 69 6f 6e 20 69 73 20 63 | 61 6c 6c 65 64 20 77 69 |ion is c|alled wi|
|00001960| 74 68 20 74 68 65 20 63 | 6f 72 72 65 63 74 20 70 |th the c|orrect p|
|00001970| 61 72 61 6d 65 74 65 72 | 73 2e 20 20 54 68 69 73 |arameter|s. This|
|00001980| 20 61 62 73 74 72 61 63 | 74 69 6f 6e 20 00 00 00 | abstrac|tion ...|
|00001990| 00 88 00 00 a5 78 00 00 | 40 4c de 05 a0 d8 ec ff |.....x..|@L......|
|000019a0| 80 07 ed ff 20 22 00 00 | 77 69 6c 6c 20 61 6c 6c |.... "..|will all|
|000019b0| 6f 77 20 74 68 65 20 70 | 72 6f 67 72 61 6d 6d 65 |ow the p|rogramme|
|000019c0| 72 20 74 6f 20 63 72 65 | 61 74 65 20 61 20 6d 6f |r to cre|ate a mo|
|000019d0| 72 65 20 50 65 72 6c 2d | 6c 69 6b 65 20 69 6e 74 |re Perl-|like int|
|000019e0| 65 72 66 61 63 65 20 74 | 6f 20 74 68 65 20 43 20 |erface t|o the C |
|000019f0| 66 75 6e 63 74 69 6f 6e | 2e 0d 07 69 0a 59 a1 00 |function|...i.Y..|
|00001a00| 0a 59 a1 00 00 00 00 00 | 00 78 00 00 a5 38 00 00 |.Y......|.x...8..|
|00001a10| 40 2a 6f 02 f9 61 ec ff | a9 98 ec ff 18 2b 00 00 |@*o..a..|.....+..|
|00001a20| 54 68 65 20 41 6e 61 74 | 6f 6d 79 20 6f 66 20 61 |The Anat|omy of a|
|00001a30| 6e 20 58 53 55 42 0d 08 | 0a 5a a1 00 00 00 00 00 |n XSUB..|.Z......|
|00001a40| 00 38 00 00 05 80 00 00 | 00 b8 91 07 c4 0c ec ff |.8......|........|
|00001a50| a4 3b ec ff 20 22 00 00 | 54 68 65 20 66 6f 6c 6c |.;.. "..|The foll|
|00001a60| 6f 77 69 6e 67 20 58 53 | 55 42 20 61 6c 6c 6f 77 |owing XS|UB allow|
|00001a70| 73 20 61 20 50 65 72 6c | 20 70 72 6f 67 72 61 6d |s a Perl| program|
|00001a80| 20 74 6f 20 61 63 63 65 | 73 73 20 61 20 43 20 6c | to acce|ss a C l|
|00001a90| 69 62 72 61 72 79 20 66 | 75 6e 63 74 69 6f 6e 20 |ibrary f|unction |
|00001aa0| 63 61 6c 6c 65 64 20 73 | 69 6e 28 29 2e 20 20 54 |called s|in(). T|
|00001ab0| 68 65 20 58 53 55 42 20 | 77 69 6c 6c 20 00 00 00 |he XSUB |will ...|
|00001ac0| 00 80 00 00 a5 8c 00 00 | 40 24 d3 05 9d d4 eb ff |........|@$......|
|00001ad0| 7d 03 ec ff 20 22 00 00 | 69 6d 69 74 61 74 65 20 |}... "..|imitate |
|00001ae0| 74 68 65 20 43 20 66 75 | 6e 63 74 69 6f 6e 20 77 |the C fu|nction w|
|00001af0| 68 69 63 68 20 74 61 6b | 65 73 20 61 20 73 69 6e |hich tak|es a sin|
|00001b00| 67 6c 65 20 61 72 67 75 | 6d 65 6e 74 20 61 6e 64 |gle argu|ment and|
|00001b10| 20 72 65 74 75 72 6e 73 | 20 61 20 73 69 6e 67 6c | returns| a singl|
|00001b20| 65 20 76 61 6c 75 65 2e | 0d 07 65 66 12 5b a1 00 |e value.|..ef.[..|
|00001b30| 12 5b a1 00 00 00 00 00 | 07 74 69 6f 0c 5c a1 00 |.[......|.tio.\..|
|00001b40| 12 5b a1 00 0c 5c a1 00 | 00 00 00 00 00 8c 00 00 |.[...\..|........|
|00001b50| 25 20 00 00 40 a0 8c 00 | 96 6d eb ff a6 94 eb ff |% ..@...|.m......|
|00001b60| 70 1a 00 00 64 6f 75 62 | 6c 65 0d 00 00 20 00 00 |p...doub|le... ..|
|00001b70| 25 20 00 00 40 a0 8c 00 | b6 3e eb ff c6 65 eb ff |% ..@...|.>...e..|
|00001b80| 70 1a 00 00 73 69 6e 28 | 78 29 0d 00 00 20 00 00 |p...sin(|x)... ..|
|00001b90| a5 4c 00 00 40 60 ea 00 | d6 0f eb ff e6 36 eb ff |.L..@`..|.....6..|
|00001ba0| 70 1a 00 00 20 20 64 6f | 75 62 6c 65 20 78 0d 08 |p... do|uble x..|
|00001bb0| 0c 5d a1 00 12 5b a1 00 | 00 00 00 00 08 65 74 65 |.]...[..|.....ete|
|00001bc0| 12 00 00 00 00 00 00 00 | 07 74 67 6f 18 5e a1 00 |........|.tgo.^..|
|00001bd0| 18 5e a1 00 00 00 00 00 | 00 4c 00 00 a5 24 00 00 |.^......|.L...$..|
|00001be0| 40 00 00 00 46 fb ea ff | 06 08 eb ff 00 00 00 00 |@...F...|........|
|00001bf0| 0d 08 29 2e 18 5f a1 00 | 00 00 00 00 00 24 00 00 |..).._..|.....$..|
|00001c00| 85 98 00 00 00 8c 87 07 | 76 a2 ea ff 56 d1 ea ff |........|v...V...|
|00001c10| 20 22 00 00 57 68 65 6e | 20 75 73 69 6e 67 20 43 | "..When| using C|
|00001c20| 20 70 6f 69 6e 74 65 72 | 73 20 74 68 65 20 69 6e | pointer|s the in|
|00001c30| 64 69 72 65 63 74 69 6f | 6e 20 6f 70 65 72 61 74 |directio|n operat|
|00001c40| 6f 72 20 07 0e 60 a1 00 | 0e 60 a1 00 00 00 00 00 |or ..`..|.`......|
|00001c50| 2a 08 65 63 0e 61 a1 00 | 00 00 00 00 20 73 68 6f |*.ec.a..|.... sho|
|00001c60| 75 6c 64 20 62 65 20 63 | 6f 6e 73 69 64 65 72 65 |uld be c|onsidere|
|00001c70| 64 20 70 61 72 74 20 6f | 66 20 74 68 65 20 74 79 |d part o|f the ty|
|00001c80| 70 65 20 61 6e 64 20 74 | 68 65 20 61 64 64 72 65 |pe and t|he addre|
|00001c90| 73 73 20 00 00 98 00 00 | 85 9c 00 00 00 c8 7b 07 |ss .....|......{.|
|00001ca0| 4f 6a ea ff 2f 99 ea ff | 20 22 00 00 6f 70 65 72 |Oj../...| "..oper|
|00001cb0| 61 74 6f 72 20 07 6d 70 | 0e 62 a1 00 0e 62 a1 00 |ator .mp|.b...b..|
|00001cc0| 00 00 00 00 26 08 70 72 | 0e 63 a1 00 00 00 00 00 |....&.pr|.c......|
|00001cd0| 20 73 68 6f 75 6c 64 20 | 62 65 20 63 6f 6e 73 69 | should |be consi|
|00001ce0| 64 65 72 65 64 20 70 61 | 72 74 20 6f 66 20 74 68 |dered pa|rt of th|
|00001cf0| 65 20 76 61 72 69 61 62 | 6c 65 2c 20 61 73 20 69 |e variab|le, as i|
|00001d00| 73 20 64 65 6d 6f 6e 73 | 74 72 61 74 65 64 20 69 |s demons|trated i|
|00001d10| 6e 20 74 68 65 20 72 70 | 63 62 5f 67 65 74 74 69 |n the rp|cb_getti|
|00001d20| 6d 65 28 29 20 66 75 6e | 63 74 69 6f 6e 20 00 00 |me() fun|ction ..|
|00001d30| 00 9c 00 00 25 80 00 00 | 40 b0 8a 07 28 32 ea ff |....%...|@...(2..|
|00001d40| 08 61 ea ff 20 22 00 00 | 61 62 6f 76 65 2e 20 20 |.a.. "..|above. |
|00001d50| 53 65 65 20 74 68 65 20 | 73 65 63 74 69 6f 6e 20 |See the |section |
|00001d60| 6f 6e 20 74 79 70 65 6d | 61 70 73 20 66 6f 72 20 |on typem|aps for |
|00001d70| 6d 6f 72 65 20 61 62 6f | 75 74 20 68 61 6e 64 6c |more abo|ut handl|
|00001d80| 69 6e 67 20 71 75 61 6c | 69 66 69 65 72 73 20 61 |ing qual|ifiers a|
|00001d90| 6e 64 20 75 6e 61 72 79 | 20 6f 70 65 72 61 74 6f |nd unary| operato|
|00001da0| 72 73 20 69 6e 20 43 20 | 74 79 70 65 73 2e 0d 00 |rs in C |types...|
|00001db0| 00 80 00 00 a5 84 00 00 | 40 60 43 05 51 c3 e9 ff |........|@`C.Q...|
|00001dc0| 31 f2 e9 ff 20 22 00 00 | 54 68 65 20 66 75 6e 63 |1... "..|The func|
|00001dd0| 74 69 6f 6e 20 6e 61 6d | 65 20 61 6e 64 20 74 68 |tion nam|e and th|
|00001de0| 65 20 72 65 74 75 72 6e | 20 74 79 70 65 20 6d 75 |e return| type mu|
|00001df0| 73 74 20 62 65 20 70 6c | 61 63 65 64 20 6f 6e 20 |st be pl|aced on |
|00001e00| 73 65 70 61 72 61 74 65 | 20 6c 69 6e 65 73 2e 0d |separate| lines..|
|00001e10| 07 72 61 72 12 64 a1 00 | 12 64 a1 00 00 00 00 00 |.rar.d..|.d......|
|00001e20| 07 69 6e 67 0c 65 a1 00 | 12 64 a1 00 0c 65 a1 00 |.ing.e..|.d...e..|
|00001e30| 00 00 00 00 00 84 00 00 | a5 6c 00 00 40 80 a9 03 |........|.l..@...|
|00001e40| 4a 5c e9 ff 5a 83 e9 ff | 70 1a 00 00 49 4e 43 4f |J\..Z...|p...INCO|
|00001e50| 52 52 45 43 54 20 20 20 | 20 20 20 20 20 20 20 20 |RRECT | |
|00001e60| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 43 4f 52 | | COR|
|00001e70| 52 45 43 54 0d 08 65 6e | 0c 66 a1 00 12 64 a1 00 |RECT..en|.f...d..|
|00001e80| 00 00 00 00 08 20 69 74 | 12 00 00 00 00 00 00 00 |..... it|........|
|00001e90| 07 65 63 65 18 67 a1 00 | 18 67 a1 00 00 00 00 00 |.ece.g..|.g......|
|00001ea0| 00 6c 00 00 a5 48 00 00 | 40 00 00 00 ba 47 e9 ff |.l...H..|@....G..|
|00001eb0| 7a 54 e9 ff 00 00 00 00 | 0d 08 65 20 18 68 a1 00 |zT......|..e .h..|
|00001ec0| 00 00 00 00 07 74 68 65 | 12 69 a1 00 12 69 a1 00 |.....the|.i...i..|
|00001ed0| 00 00 00 00 07 65 74 75 | 0c 6a a1 00 12 69 a1 00 |.....etu|.j...i..|
|00001ee0| 0c 6a a1 00 00 00 00 00 | 00 48 00 00 25 40 00 00 |.j......|.H..%@..|
|00001ef0| 40 10 92 03 ba f6 e8 ff | ca 1d e9 ff 70 1a 00 00 |@.......|....p...|
|00001f00| 64 6f 75 62 6c 65 20 73 | 69 6e 28 78 29 20 20 20 |double s|in(x) |
|00001f10| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001f20| 20 64 6f 75 62 6c 65 0d | 00 40 00 00 25 40 00 00 | double.|.@..%@..|
|00001f30| 40 10 92 03 da c7 e8 ff | ea ee e8 ff 70 1a 00 00 |@.......|....p...|
|00001f40| 20 20 64 6f 75 62 6c 65 | 20 78 20 20 20 20 20 20 | double| x |
|00001f50| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001f60| 20 73 69 6e 28 78 29 0d | 00 40 00 00 a5 70 00 00 | sin(x).|.@...p..|
|00001f70| 40 d0 ef 03 fa 98 e8 ff | 0a c0 e8 ff 70 1a 00 00 |@.......|....p...|
|00001f80| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001f90| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001fa0| 20 20 20 64 6f 75 62 6c | 65 20 78 0d 08 45 3a 20 | doubl|e x..E: |
|00001fb0| 0c 6b a1 00 12 69 a1 00 | 00 00 00 00 08 6e 6f 74 |.k...i..|.....not|
|00001fc0| 12 00 00 00 00 00 00 00 | 07 82 a1 00 18 6c a1 00 |........|.....l..|
|00001fd0| 18 6c a1 00 00 00 00 00 | 00 70 00 00 a5 24 00 00 |.l......|.p...$..|
|00001fe0| 40 00 00 00 6a 84 e8 ff | 2a 91 e8 ff 00 00 00 00 |@...j...|*.......|
|00001ff0| 0d 08 73 68 18 6d a1 00 | 00 00 00 00 00 24 00 00 |..sh.m..|.....$..|
|00002000| 05 84 00 00 00 60 e6 07 | 9a 2b e8 ff 7a 5a e8 ff |.....`..|.+..zZ..|
|00002010| 20 22 00 00 54 68 65 20 | 66 75 6e 63 74 69 6f 6e | "..The |function|
|00002020| 20 62 6f 64 79 20 6d 61 | 79 20 62 65 20 69 6e 64 | body ma|y be ind|
|00002030| 65 6e 74 65 64 20 6f 72 | 20 6c 65 66 74 2d 61 64 |ented or| left-ad|
|00002040| 6a 75 73 74 65 64 2e 20 | 20 54 68 65 20 66 6f 6c |justed. | The fol|
|00002050| 6c 6f 77 69 6e 67 20 65 | 78 61 6d 70 6c 65 20 73 |lowing e|xample s|
|00002060| 68 6f 77 73 20 61 20 66 | 75 6e 63 74 69 6f 6e 20 |hows a f|unction |
|00002070| 77 69 74 68 20 69 74 73 | 20 62 6f 64 79 20 00 00 |with its| body ..|
|00002080| 00 84 00 00 a5 80 00 00 | 40 90 fb 04 73 f3 e7 ff |........|@...s...|
|00002090| 53 22 e8 ff 20 22 00 00 | 6c 65 66 74 2d 61 64 6a |S".. "..|left-adj|
|000020a0| 75 73 74 65 64 2e 20 20 | 4d 6f 73 74 20 65 78 61 |usted. |Most exa|
|000020b0| 6d 70 6c 65 73 20 69 6e | 20 74 68 69 73 20 64 6f |mples in| this do|
|000020c0| 63 75 6d 65 6e 74 20 77 | 69 6c 6c 20 69 6e 64 65 |cument w|ill inde|
|000020d0| 6e 74 20 74 68 65 20 62 | 6f 64 79 2e 0d 07 6e 20 |nt the b|ody...n |
|000020e0| 12 6e a1 00 12 6e a1 00 | 00 00 00 00 07 20 63 61 |.n...n..|..... ca|
|000020f0| 0c 6f a1 00 12 6e a1 00 | 0c 6f a1 00 00 00 00 00 |.o...n..|.o......|
|00002100| 00 80 00 00 a5 4c 00 00 | 40 10 a4 00 6c 8c e7 ff |.....L..|@...l...|
|00002110| 7c b3 e7 ff 70 1a 00 00 | 43 4f 52 52 45 43 54 0d ||...p...|CORRECT.|
|00002120| 08 67 66 61 0c 70 a1 00 | 12 6e a1 00 00 00 00 00 |.gfa.p..|.n......|
|00002130| 08 20 77 68 12 00 00 00 | 00 00 00 00 07 61 73 20 |. wh....|.....as |
|00002140| 18 71 a1 00 18 71 a1 00 | 00 00 00 00 00 4c 00 00 |.q...q..|.....L..|
|00002150| a5 48 00 00 40 00 00 00 | dc 77 e7 ff 9c 84 e7 ff |.H..@...|.w......|
|00002160| 00 00 00 00 0d 08 a1 00 | 18 72 a1 00 00 00 00 00 |........|.r......|
|00002170| 07 6f 69 64 12 73 a1 00 | 12 73 a1 00 00 00 00 00 |.oid.s..|.s......|
|00002180| 07 20 54 68 0c 74 a1 00 | 12 73 a1 00 0c 74 a1 00 |. Th.t..|.s...t..|
|00002190| 00 00 00 00 00 48 00 00 | 01 10 00 00 41 a0 8c 00 |.....H..|....A...|
|000021a0| 00 00 00 00 00 10 00 00 | 02 1c 00 00 00 04 00 00 |........|........|
|000021b0| 00 00 00 00 12 73 a1 00 | 0c 74 a1 00 00 00 00 00 |.....s..|.t......|
|000021c0| 00 1c 00 00 25 2c 00 00 | 40 a0 8c 00 ee 4c e5 ff |....%,..|@....L..|
|000021d0| fe 73 e5 ff 70 1a 00 00 | 16 00 00 00 b0 fc 07 00 |.s..p...|........|
|000021e0| 00 00 00 00 64 6f 75 62 | 6c 65 0d 00 00 2c 00 00 |....doub|le...,..|
|000021f0| 25 20 00 00 40 a0 8c 00 | 0e 1e e5 ff 1e 45 e5 ff |% ..@...|.....E..|
|00002200| 70 1a 00 00 73 69 6e 28 | 78 29 0d 00 00 20 00 00 |p...sin(|x)... ..|
|00002210| a5 4c 00 00 40 80 bb 00 | 2e ef e4 ff 3e 16 e5 ff |.L..@...|....>...|
|00002220| 70 1a 00 00 64 6f 75 62 | 6c 65 20 78 0d 08 00 00 |p...doub|le x....|
|00002230| 0c 75 a1 00 12 73 a1 00 | 00 00 00 00 08 00 00 00 |.u...s..|........|
|00002240| 12 00 00 00 00 00 00 00 | 07 20 73 6f 18 76 a1 00 |........|. so.v..|
|00002250| 18 76 a1 00 00 00 00 00 | 00 4c 00 00 a5 34 00 00 |.v......|.L...4..|
|00002260| 40 00 00 00 9e da e4 ff | 5e e7 e4 ff 00 00 00 00 |@.......|^.......|
|00002270| 0d 08 62 69 18 77 a1 00 | 00 00 00 00 07 77 65 65 |..bi.w..|.....wee|
|00002280| 0a 78 a1 00 0a 78 a1 00 | 00 00 00 00 00 34 00 00 |.x...x..|.....4..|
|00002290| a5 34 00 00 40 78 ef 01 | fe 79 e4 ff ae b0 e4 ff |.4..@x..|.y......|
|000022a0| 18 2b 00 00 54 68 65 20 | 41 72 67 75 6d 65 6e 74 |.+..The |Argument|
|000022b0| 20 53 74 61 63 6b 0d 08 | 0a 79 a1 00 00 00 00 00 | Stack..|.y......|
|000022c0| 00 34 00 00 05 84 00 00 | 00 f4 ac 07 c9 24 e4 ff |.4......|.....$..|
|000022d0| a9 53 e4 ff 20 22 00 00 | 54 68 65 20 61 72 67 75 |.S.. "..|The argu|
|000022e0| 6d 65 6e 74 20 73 74 61 | 63 6b 20 69 73 20 75 73 |ment sta|ck is us|
|000022f0| 65 64 20 74 6f 20 73 74 | 6f 72 65 20 74 68 65 20 |ed to st|ore the |
|00002300| 76 61 6c 75 65 73 20 77 | 68 69 63 68 20 61 72 65 |values w|hich are|
|00002310| 20 73 65 6e 74 20 61 73 | 20 70 61 72 61 6d 65 74 | sent as| paramet|
|00002320| 65 72 73 20 74 6f 20 74 | 68 65 20 58 53 55 42 20 |ers to t|he XSUB |
|00002330| 61 6e 64 20 74 6f 20 73 | 74 6f 72 65 20 74 68 65 |and to s|tore the|
|00002340| 20 00 00 00 00 84 00 00 | 05 84 00 00 00 b8 88 07 | .......|........|
|00002350| a2 ec e3 ff 82 1b e4 ff | 20 22 00 00 58 53 55 42 |........| "..XSUB|
|00002360| 27 73 20 72 65 74 75 72 | 6e 20 76 61 6c 75 65 2e |'s retur|n value.|
|00002370| 20 20 49 6e 20 72 65 61 | 6c 69 74 79 20 61 6c 6c | In rea|lity all|
|00002380| 20 50 65 72 6c 20 66 75 | 6e 63 74 69 6f 6e 73 20 | Perl fu|nctions |
|00002390| 6b 65 65 70 20 74 68 65 | 69 72 20 76 61 6c 75 65 |keep the|ir value|
|000023a0| 73 20 6f 6e 20 74 68 69 | 73 20 73 74 61 63 6b 20 |s on thi|s stack |
|000023b0| 61 74 20 74 68 65 20 73 | 61 6d 65 20 74 69 6d 65 |at the s|ame time|
|000023c0| 2c 20 65 61 63 68 20 00 | 00 84 00 00 05 88 00 00 |, each .|........|
|000023d0| 00 fc a4 07 7b b4 e3 ff | 5b e3 e3 ff 20 22 00 00 |....{...|[... "..|
|000023e0| 6c 69 6d 69 74 65 64 20 | 74 6f 20 69 74 73 20 6f |limited |to its o|
|000023f0| 77 6e 20 72 61 6e 67 65 | 20 6f 66 20 70 6f 73 69 |wn range| of posi|
|00002400| 74 69 6f 6e 73 20 6f 6e | 20 74 68 65 20 73 74 61 |tions on| the sta|
|00002410| 63 6b 2e 20 20 49 6e 20 | 74 68 69 73 20 64 6f 63 |ck. In |this doc|
|00002420| 75 6d 65 6e 74 20 74 68 | 65 20 66 69 72 73 74 20 |ument th|e first |
|00002430| 70 6f 73 69 74 69 6f 6e | 20 6f 6e 20 74 68 61 74 |position| on that|
|00002440| 20 73 74 61 63 6b 20 77 | 68 69 63 68 20 00 00 00 | stack w|hich ...|
|00002450| 00 88 00 00 25 6c 00 00 | 40 44 c8 05 54 7c e3 ff |....%l..|@D..T|..|
|00002460| 34 ab e3 ff 20 22 00 00 | 62 65 6c 6f 6e 67 73 20 |4... "..|belongs |
|00002470| 74 6f 20 74 68 65 20 61 | 63 74 69 76 65 20 66 75 |to the a|ctive fu|
|00002480| 6e 63 74 69 6f 6e 20 77 | 69 6c 6c 20 62 65 20 72 |nction w|ill be r|
|00002490| 65 66 65 72 72 65 64 20 | 74 6f 20 61 73 20 70 6f |eferred |to as po|
|000024a0| 73 69 74 69 6f 6e 20 30 | 20 66 6f 72 20 74 68 61 |sition 0| for tha|
|000024b0| 74 20 66 75 6e 63 74 69 | 6f 6e 2e 0d 00 6c 00 00 |t functi|on...l..|
|000024c0| 85 bc 00 00 00 24 ec 07 | 7d 0d e3 ff 5d 3c e3 ff |.....$..|}...]<..|
|000024d0| 20 22 00 00 58 53 55 42 | 73 20 72 65 66 65 72 20 | "..XSUB|s refer |
|000024e0| 74 6f 20 74 68 65 69 72 | 20 73 74 61 63 6b 20 61 |to their| stack a|
|000024f0| 72 67 75 6d 65 6e 74 73 | 20 77 69 74 68 20 74 68 |rguments| with th|
|00002500| 65 20 6d 61 63 72 6f 20 | 07 66 69 6c 10 7a a1 00 |e macro |.fil.z..|
|00002510| 10 7a a1 00 00 00 00 00 | 53 54 28 78 29 08 4d 4f |.z......|ST(x).MO|
|00002520| 10 00 00 00 00 00 00 00 | 2c 20 77 68 65 72 65 20 |........|, where |
|00002530| 07 73 20 72 11 7b a1 00 | 11 7b a1 00 00 00 00 00 |.s r.{..|.{......|
|00002540| 78 08 20 77 11 00 00 00 | 00 00 00 00 20 72 65 66 |x. w....|.... ref|
|00002550| 65 72 73 20 74 6f 20 61 | 20 70 6f 73 69 74 69 6f |ers to a| positio|
|00002560| 6e 20 69 6e 20 74 68 69 | 73 20 58 53 55 42 27 73 |n in thi|s XSUB's|
|00002570| 20 70 61 72 74 20 00 00 | 00 bc 00 00 05 80 00 00 | part ..|........|
|00002580| 00 d8 ad 07 56 d5 e2 ff | 36 04 e3 ff 20 22 00 00 |....V...|6... "..|
|00002590| 6f 66 20 74 68 65 20 73 | 74 61 63 6b 2e 20 20 50 |of the s|tack. P|
|000025a0| 6f 73 69 74 69 6f 6e 20 | 30 20 66 6f 72 20 74 68 |osition |0 for th|
|000025b0| 61 74 20 66 75 6e 63 74 | 69 6f 6e 20 77 6f 75 6c |at funct|ion woul|
|000025c0| 64 20 62 65 20 6b 6e 6f | 77 6e 20 74 6f 20 74 68 |d be kno|wn to th|
|000025d0| 65 20 58 53 55 42 20 61 | 73 20 53 54 28 30 29 2e |e XSUB a|s ST(0).|
|000025e0| 20 20 54 68 65 20 58 53 | 55 42 27 73 20 69 6e 63 | The XS|UB's inc|
|000025f0| 6f 6d 69 6e 67 20 00 00 | 00 80 00 00 85 9c 00 00 |oming ..|........|
|00002600| 00 80 db 07 2f 9d e2 ff | 0f cc e2 ff 20 22 00 00 |..../...|.... "..|
|00002610| 70 61 72 61 6d 65 74 65 | 72 73 20 61 6e 64 20 6f |paramete|rs and o|
|00002620| 75 74 67 6f 69 6e 67 20 | 72 65 74 75 72 6e 20 76 |utgoing |return v|
|00002630| 61 6c 75 65 73 20 61 6c | 77 61 79 73 20 62 65 67 |alues al|ways beg|
|00002640| 69 6e 20 61 74 20 53 54 | 28 30 29 2e 20 20 46 6f |in at ST|(0). Fo|
|00002650| 72 20 6d 61 6e 79 20 73 | 69 6d 70 6c 65 20 63 61 |r many s|imple ca|
|00002660| 73 65 73 20 74 68 65 20 | 07 98 a1 00 10 7c a1 00 |ses the |.....|..|
|00002670| 10 7c a1 00 00 00 00 00 | 78 73 75 62 70 70 08 77 |.|......|xsubpp.w|
|00002680| 10 00 00 00 00 00 00 00 | 20 63 6f 6d 70 69 6c 65 |........| compile|
|00002690| 72 20 00 00 00 9c 00 00 | 05 80 00 00 00 b0 b4 07 |r ......|........|
|000026a0| 08 65 e2 ff e8 93 e2 ff | 20 22 00 00 77 69 6c 6c |.e......| "..will|
|000026b0| 20 67 65 6e 65 72 61 74 | 65 20 74 68 65 20 63 6f | generat|e the co|
|000026c0| 64 65 20 6e 65 63 65 73 | 73 61 72 79 20 74 6f 20 |de neces|sary to |
|000026d0| 68 61 6e 64 6c 65 20 74 | 68 65 20 61 72 67 75 6d |handle t|he argum|
|000026e0| 65 6e 74 20 73 74 61 63 | 6b 20 62 79 20 65 6d 62 |ent stac|k by emb|
|000026f0| 65 64 64 69 6e 67 20 63 | 6f 64 65 20 66 72 61 67 |edding c|ode frag|
|00002700| 6d 65 6e 74 73 20 66 6f | 75 6e 64 20 69 6e 20 74 |ments fo|und in t|
|00002710| 68 65 20 00 00 80 00 00 | a5 6c 00 00 40 b0 62 05 |he .....|.l..@.b.|
|00002720| e1 2c e2 ff c1 5b e2 ff | 20 22 00 00 74 79 70 65 |.,...[..| "..type|
|00002730| 6d 61 70 73 2e 20 20 49 | 6e 20 6d 6f 72 65 20 63 |maps. I|n more c|
|00002740| 6f 6d 70 6c 65 78 20 63 | 61 73 65 73 20 74 68 65 |omplex c|ases the|
|00002750| 20 70 72 6f 67 72 61 6d | 6d 65 72 20 6d 75 73 74 | program|mer must|
|00002760| 20 73 75 70 70 6c 79 20 | 74 68 65 20 63 6f 64 65 | supply |the code|
|00002770| 2e 0d 07 20 0a 7d a1 00 | 0a 7d a1 00 00 00 00 00 |... .}..|.}......|
|00002780| 00 6c 00 00 a5 38 00 00 | 40 d8 0f 02 3a b6 e1 ff |.l...8..|@...:...|
|00002790| ea ec e1 ff 18 2b 00 00 | 54 68 65 20 52 45 54 56 |.....+..|The RETV|
|000027a0| 41 4c 20 56 61 72 69 61 | 62 6c 65 0d 08 00 00 00 |AL Varia|ble.....|
|000027b0| 0a 7e a1 00 00 00 00 00 | 00 38 00 00 05 84 00 00 |.~......|.8......|
|000027c0| 00 9c c2 07 05 61 e1 ff | e5 8f e1 ff 20 22 00 00 |.....a..|.... "..|
|000027d0| 54 68 65 20 52 45 54 56 | 41 4c 20 76 61 72 69 61 |The RETV|AL varia|
|000027e0| 62 6c 65 20 69 73 20 61 | 20 6d 61 67 69 63 20 76 |ble is a| magic v|
|000027f0| 61 72 69 61 62 6c 65 20 | 77 68 69 63 68 20 61 6c |ariable |which al|
|00002800| 77 61 79 73 20 6d 61 74 | 63 68 65 73 20 74 68 65 |ways mat|ches the|
|00002810| 20 72 65 74 75 72 6e 20 | 74 79 70 65 20 6f 66 20 | return |type of |
|00002820| 74 68 65 20 43 20 6c 69 | 62 72 61 72 79 20 66 75 |the C li|brary fu|
|00002830| 6e 63 74 69 6f 6e 2e 20 | 20 00 00 00 00 84 00 00 |nction. | .......|
|00002840| 85 9c 00 00 00 64 af 07 | de 28 e1 ff be 57 e1 ff |.....d..|.(...W..|
|00002850| 20 22 00 00 54 68 65 20 | 07 4b 41 47 10 7f a1 00 | "..The |.KAG....|
|00002860| 10 7f a1 00 00 00 00 00 | 78 73 75 62 70 70 08 00 |........|xsubpp..|
|00002870| 10 00 00 00 00 00 00 00 | 20 63 6f 6d 70 69 6c 65 |........| compile|
|00002880| 72 20 77 69 6c 6c 20 73 | 75 70 70 6c 79 20 74 68 |r will s|upply th|
|00002890| 69 73 20 76 61 72 69 61 | 62 6c 65 20 69 6e 20 65 |is varia|ble in e|
|000028a0| 61 63 68 20 58 53 55 42 | 20 61 6e 64 20 62 79 20 |ach XSUB| and by |
|000028b0| 64 65 66 61 75 6c 74 20 | 77 69 6c 6c 20 75 73 65 |default |will use|
|000028c0| 20 69 74 20 74 6f 20 68 | 6f 6c 64 20 74 68 65 20 | it to h|old the |
|000028d0| 72 65 74 75 72 6e 20 00 | 00 9c 00 00 05 84 00 00 |return .|........|
|000028e0| 00 cc cb 07 b7 f0 e0 ff | 97 1f e1 ff 20 22 00 00 |........|.... "..|
|000028f0| 76 61 6c 75 65 20 6f 66 | 20 74 68 65 20 43 20 6c |value of| the C l|
|00002900| 69 62 72 61 72 79 20 66 | 75 6e 63 74 69 6f 6e 20 |ibrary f|unction |
|00002910| 62 65 69 6e 67 20 63 61 | 6c 6c 65 64 2e 20 20 49 |being ca|lled. I|
|00002920| 6e 20 73 69 6d 70 6c 65 | 20 63 61 73 65 73 20 74 |n simple| cases t|
|00002930| 68 65 20 76 61 6c 75 65 | 20 6f 66 20 52 45 54 56 |he value| of RETV|
|00002940| 41 4c 20 77 69 6c 6c 20 | 62 65 20 70 6c 61 63 65 |AL will |be place|
|00002950| 64 20 69 6e 20 53 54 28 | 30 29 20 00 00 84 00 00 |d in ST(|0) .....|
|00002960| 25 70 00 00 40 fc 69 06 | 90 b8 e0 ff 70 e7 e0 ff |%p..@.i.|....p...|
|00002970| 20 22 00 00 6f 66 20 74 | 68 65 20 61 72 67 75 6d | "..of t|he argum|
|00002980| 65 6e 74 20 73 74 61 63 | 6b 20 77 68 65 72 65 20 |ent stac|k where |
|00002990| 69 74 20 63 61 6e 20 62 | 65 20 72 65 63 65 69 76 |it can b|e receiv|
|000029a0| 65 64 20 62 79 20 50 65 | 72 6c 20 61 73 20 74 68 |ed by Pe|rl as th|
|000029b0| 65 20 72 65 74 75 72 6e | 20 76 61 6c 75 65 20 6f |e return| value o|
|000029c0| 66 20 74 68 65 20 58 53 | 55 42 2e 0d 00 70 00 00 |f the XS|UB...p..|
|000029d0| 85 98 00 00 00 08 6c 07 | b9 49 e0 ff 99 78 e0 ff |......l.|.I...x..|
|000029e0| 20 22 00 00 49 66 20 74 | 68 65 20 58 53 55 42 20 | "..If t|he XSUB |
|000029f0| 68 61 73 20 61 20 72 65 | 74 75 72 6e 20 74 79 70 |has a re|turn typ|
|00002a00| 65 20 6f 66 20 07 67 68 | 0e 80 a1 00 0e 80 a1 00 |e of .gh|........|
|00002a10| 00 00 00 00 76 6f 69 64 | 08 6f 70 74 0e 81 a1 00 |....void|.opt....|
|00002a20| 00 00 00 00 20 74 68 65 | 6e 20 74 68 65 20 63 6f |.... the|n the co|
|00002a30| 6d 70 69 6c 65 72 20 77 | 69 6c 6c 20 6e 6f 74 20 |mpiler w|ill not |
|00002a40| 73 75 70 70 6c 79 20 61 | 20 52 45 54 56 41 4c 20 |supply a| RETVAL |
|00002a50| 76 61 72 69 61 62 6c 65 | 20 66 6f 72 20 74 68 61 |variable| for tha|
|00002a60| 74 20 00 00 00 98 00 00 | 25 80 00 00 40 54 bc 07 |t ......|%...@T..|
|00002a70| 92 11 e0 ff 72 40 e0 ff | 20 22 00 00 66 75 6e 63 |....r@..| "..func|
|00002a80| 74 69 6f 6e 2e 20 20 57 | 68 65 6e 20 75 73 69 6e |tion. W|hen usin|
|00002a90| 67 20 74 68 65 20 50 50 | 43 4f 44 45 3a 20 64 69 |g the PP|CODE: di|
|00002aa0| 72 65 63 74 69 76 65 20 | 74 68 65 20 52 45 54 56 |rective |the RETV|
|00002ab0| 41 4c 20 76 61 72 69 61 | 62 6c 65 20 69 73 20 6e |AL varia|ble is n|
|00002ac0| 6f 74 20 6e 65 65 64 65 | 64 2c 20 75 6e 6c 65 73 |ot neede|d, unles|
|00002ad0| 73 20 75 73 65 64 20 65 | 78 70 6c 69 63 69 74 6c |s used e|xplicitl|
|00002ae0| 79 2e 0d 00 00 80 00 00 | 85 98 00 00 00 a8 8c 07 |y.......|........|
|00002af0| bb a2 df ff 9b d1 df ff | 20 22 00 00 49 66 20 50 |........| "..If P|
|00002b00| 50 43 4f 44 45 3a 20 64 | 69 72 65 63 74 69 76 65 |PCODE: d|irective|
|00002b10| 20 69 73 20 6e 6f 74 20 | 75 73 65 64 2c 20 07 66 | is not |used, .f|
|00002b20| 0e 82 a1 00 0e 82 a1 00 | 00 00 00 00 76 6f 69 64 |........|....void|
|00002b30| 08 74 69 6f 0e 83 a1 00 | 00 00 00 00 20 72 65 74 |.tio....|.... ret|
|00002b40| 75 72 6e 20 76 61 6c 75 | 65 20 73 68 6f 75 6c 64 |urn valu|e should|
|00002b50| 20 62 65 20 75 73 65 64 | 20 6f 6e 6c 79 20 66 6f | be used| only fo|
|00002b60| 72 20 73 75 62 72 6f 75 | 74 69 6e 65 73 20 77 68 |r subrou|tines wh|
|00002b70| 69 63 68 20 64 6f 20 6e | 6f 74 20 00 00 98 00 00 |ich do n|ot .....|
|00002b80| a5 80 00 00 40 64 78 05 | 94 6a df ff 74 99 df ff |....@dx.|.j..t...|
|00002b90| 20 22 00 00 72 65 74 75 | 72 6e 20 61 20 76 61 6c | "..retu|rn a val|
|00002ba0| 75 65 2c 20 07 08 05 05 | 11 84 a1 00 11 84 a1 00 |ue, ....|........|
|00002bb0| 00 00 00 00 65 76 65 6e | 20 69 66 08 11 00 00 00 |....even| if.....|
|00002bc0| 00 00 00 00 20 43 4f 44 | 45 3a 20 64 69 72 65 63 |.... COD|E: direc|
|00002bd0| 74 69 76 65 20 69 73 20 | 75 73 65 64 20 77 68 69 |tive is |used whi|
|00002be0| 63 68 20 73 65 74 73 20 | 53 54 28 30 29 20 65 78 |ch sets |ST(0) ex|
|00002bf0| 70 6c 69 63 69 74 6c 79 | 2e 0d 00 00 00 80 00 00 |plicitly|........|
|00002c00| 85 98 00 00 00 34 b2 07 | bd fb de ff 9d 2a df ff |.....4..|.....*..|
|00002c10| 20 22 00 00 4f 6c 64 65 | 72 20 76 65 72 73 69 6f | "..Olde|r versio|
|00002c20| 6e 73 20 6f 66 20 74 68 | 69 73 20 64 6f 63 75 6d |ns of th|is docum|
|00002c30| 65 6e 74 20 72 65 63 6f | 6d 6d 65 6e 64 65 64 20 |ent reco|mmended |
|00002c40| 74 6f 20 75 73 65 20 07 | 0e 85 a1 00 0e 85 a1 00 |to use .|........|
|00002c50| 00 00 00 00 76 6f 69 64 | 08 6f 75 6c 0e 86 a1 00 |....void|.oul....|
|00002c60| 00 00 00 00 20 72 65 74 | 75 72 6e 20 76 61 6c 75 |.... ret|urn valu|
|00002c70| 65 20 69 6e 20 73 75 63 | 68 20 63 61 73 65 73 2e |e in suc|h cases.|
|00002c80| 20 49 74 20 77 61 73 20 | 64 69 73 63 6f 76 65 72 | It was |discover|
|00002c90| 65 64 20 00 00 98 00 00 | 85 b8 00 00 00 00 ec 07 |ed .....|........|
|00002ca0| 96 c3 de ff 76 f2 de ff | 20 22 00 00 74 68 61 74 |....v...| "..that|
|00002cb0| 20 74 68 69 73 20 63 6f | 75 6c 64 20 6c 65 61 64 | this co|uld lead|
|00002cc0| 20 74 6f 20 73 65 67 66 | 61 75 6c 74 73 20 69 6e | to segf|aults in|
|00002cd0| 20 63 61 73 65 73 20 77 | 68 65 6e 20 58 53 55 42 | cases w|hen XSUB|
|00002ce0| 20 77 61 73 20 07 05 05 | 11 87 a1 00 11 87 a1 00 | was ...|........|
|00002cf0| 00 00 00 00 74 72 75 65 | 6c 79 08 00 11 00 00 00 |....true|ly......|
|00002d00| 00 00 00 00 20 07 a1 00 | 0e 88 a1 00 0e 88 a1 00 |.... ...|........|
|00002d10| 00 00 00 00 76 6f 69 64 | 08 45 20 3d 0e 89 a1 00 |....void|.E =....|
|00002d20| 00 00 00 00 2e 20 54 68 | 69 73 20 70 72 61 63 74 |..... Th|is pract|
|00002d30| 69 63 65 20 69 73 20 6e | 6f 77 20 64 65 70 72 65 |ice is n|ow depre|
|00002d40| 63 61 74 65 64 2c 20 61 | 6e 64 20 00 00 b8 00 00 |cated, a|nd .....|
|00002d50| 85 b4 00 00 00 9c e0 07 | 6f 8b de ff 4f ba de ff |........|o...O...|
|00002d60| 20 22 00 00 6d 61 79 20 | 62 65 20 6e 6f 74 20 73 | "..may |be not s|
|00002d70| 75 70 70 6f 72 74 65 64 | 20 61 74 20 73 6f 6d 65 |upported| at some|
|00002d80| 20 66 75 74 75 72 65 20 | 76 65 72 73 69 6f 6e 2e | future |version.|
|00002d90| 20 55 73 65 20 74 68 65 | 20 72 65 74 75 72 6e 20 | Use the| return |
|00002da0| 76 61 6c 75 65 20 07 00 | 0e 8a a1 00 0e 8a a1 00 |value ..|........|
|00002db0| 00 00 00 00 53 56 20 2a | 08 72 64 20 0e 8b a1 00 |....SV *|.rd ....|
|00002dc0| 00 00 00 00 20 69 6e 20 | 73 75 63 68 20 63 61 73 |.... in |such cas|
|00002dd0| 65 73 2e 20 28 43 75 72 | 72 65 6e 74 6c 79 20 07 |es. (Cur|rently .|
|00002de0| 0e 8c a1 00 0e 8c a1 00 | 00 00 00 00 78 73 75 62 |........|....xsub|
|00002df0| 70 70 08 64 0e 8d a1 00 | 00 00 00 00 20 00 00 00 |pp.d....|.... ...|
|00002e00| 00 b4 00 00 05 84 00 00 | 00 30 e3 07 48 53 de ff |........|.0..HS..|
|00002e10| 28 82 de ff 20 22 00 00 | 63 6f 6e 74 61 69 6e 73 |(... "..|contains|
|00002e20| 20 73 6f 6d 65 20 68 65 | 75 72 69 73 74 69 63 20 | some he|uristic |
|00002e30| 63 6f 64 65 20 77 68 69 | 63 68 20 74 72 69 65 73 |code whi|ch tries|
|00002e40| 20 74 6f 20 64 69 73 61 | 6d 62 69 67 75 61 74 65 | to disa|mbiguate|
|00002e50| 20 62 65 74 77 65 65 6e | 20 22 74 72 75 65 6c 79 | between| "truely|
|00002e60| 2d 76 6f 69 64 22 20 61 | 6e 64 20 22 6f 6c 64 2d |-void" a|nd "old-|
|00002e70| 70 72 61 63 74 69 63 65 | 2d 64 65 63 6c 61 72 65 |practice|-declare|
|00002e80| 64 2d 00 00 00 84 00 00 | a5 a8 00 00 40 b4 9b 07 |d-......|....@...|
|00002e90| 21 1b de ff 01 4a de ff | 20 22 00 00 61 73 2d 76 |!....J..| "..as-v|
|00002ea0| 6f 69 64 22 20 66 75 6e | 63 74 69 6f 6e 73 2e 20 |oid" fun|ctions. |
|00002eb0| 48 65 6e 63 65 20 79 6f | 75 72 20 63 6f 64 65 20 |Hence yo|ur code |
|00002ec0| 69 73 20 61 74 20 6d 65 | 72 63 79 20 6f 66 20 74 |is at me|rcy of t|
|00002ed0| 68 69 73 20 68 65 75 72 | 69 73 74 69 63 73 20 75 |his heur|istics u|
|00002ee0| 6e 6c 65 73 73 20 79 6f | 75 20 75 73 65 20 07 75 |nless yo|u use .u|
|00002ef0| 0e 8e a1 00 0e 8e a1 00 | 00 00 00 00 53 56 20 2a |........|....SV *|
|00002f00| 08 20 63 6f 0e 8f a1 00 | 00 00 00 00 20 61 73 20 |. co....|.... as |
|00002f10| 72 65 74 75 72 6e 20 76 | 61 6c 75 65 2e 29 0d 07 |return v|alue.)..|
|00002f20| 0a 90 a1 00 0a 90 a1 00 | 00 00 00 00 00 a8 00 00 |........|........|
|00002f30| a5 34 00 00 40 52 3b 02 | 7a a4 dd ff 2a db dd ff |.4..@R;.|z...*...|
|00002f40| 18 2b 00 00 54 68 65 20 | 4d 4f 44 55 4c 45 20 4b |.+..The |MODULE K|
|00002f50| 65 79 77 6f 72 64 0d 08 | 0a 91 a1 00 00 00 00 00 |eyword..|........|
|00002f60| 00 34 00 00 05 80 00 00 | 00 14 c9 07 45 4f dd ff |.4......|....EO..|
|00002f70| 25 7e dd ff 20 22 00 00 | 54 68 65 20 4d 4f 44 55 |%~.. "..|The MODU|
|00002f80| 4c 45 20 6b 65 79 77 6f | 72 64 20 69 73 20 75 73 |LE keywo|rd is us|
|00002f90| 65 64 20 74 6f 20 73 74 | 61 72 74 20 74 68 65 20 |ed to st|art the |
|00002fa0| 58 53 20 63 6f 64 65 20 | 61 6e 64 20 74 6f 20 73 |XS code |and to s|
|00002fb0| 70 65 63 69 66 79 20 74 | 68 65 20 70 61 63 6b 61 |pecify t|he packa|
|00002fc0| 67 65 20 6f 66 20 74 68 | 65 20 66 75 6e 63 74 69 |ge of th|e functi|
|00002fd0| 6f 6e 73 20 77 68 69 63 | 68 20 61 72 65 20 00 00 |ons whic|h are ..|
|00002fe0| 00 80 00 00 05 84 00 00 | 00 78 f5 07 1e 17 dd ff |........|.x......|
|00002ff0| fe 45 dd ff 20 22 00 00 | 62 65 69 6e 67 20 64 65 |.E.. "..|being de|
|00003000| 66 69 6e 65 64 2e 20 20 | 41 6c 6c 20 74 65 78 74 |fined. |All text|
|00003010| 20 70 72 65 63 65 64 69 | 6e 67 20 74 68 65 20 66 | precedi|ng the f|
|00003020| 69 72 73 74 20 4d 4f 44 | 55 4c 45 20 6b 65 79 77 |irst MOD|ULE keyw|
|00003030| 6f 72 64 20 69 73 20 63 | 6f 6e 73 69 64 65 72 65 |ord is c|onsidere|
|00003040| 64 20 43 20 63 6f 64 65 | 20 61 6e 64 20 69 73 20 |d C code| and is |
|00003050| 70 61 73 73 65 64 20 74 | 68 72 6f 75 67 68 20 74 |passed t|hrough t|
|00003060| 6f 20 00 00 00 84 00 00 | 05 80 00 00 00 f4 be 07 |o ......|........|
|00003070| f7 de dc ff d7 0d dd ff | 20 22 00 00 74 68 65 20 |........| "..the |
|00003080| 6f 75 74 70 75 74 20 75 | 6e 74 6f 75 63 68 65 64 |output u|ntouched|
|00003090| 2e 20 20 45 76 65 72 79 | 20 58 53 20 6d 6f 64 75 |. Every| XS modu|
|000030a0| 6c 65 20 77 69 6c 6c 20 | 68 61 76 65 20 61 20 62 |le will |have a b|
|000030b0| 6f 6f 74 73 74 72 61 70 | 20 66 75 6e 63 74 69 6f |ootstrap| functio|
|000030c0| 6e 20 77 68 69 63 68 20 | 69 73 20 75 73 65 64 20 |n which |is used |
|000030d0| 74 6f 20 68 6f 6f 6b 20 | 74 68 65 20 58 53 55 42 |to hook |the XSUB|
|000030e0| 73 20 00 00 00 80 00 00 | 05 84 00 00 00 a4 e7 07 |s ......|........|
|000030f0| d0 a6 dc ff b0 d5 dc ff | 20 22 00 00 69 6e 74 6f |........| "..into|
|00003100| 20 50 65 72 6c 2e 20 20 | 54 68 65 20 70 61 63 6b | Perl. |The pack|
|00003110| 61 67 65 20 6e 61 6d 65 | 20 6f 66 20 74 68 69 73 |age name| of this|
|00003120| 20 62 6f 6f 74 73 74 72 | 61 70 20 66 75 6e 63 74 | bootstr|ap funct|
|00003130| 69 6f 6e 20 77 69 6c 6c | 20 6d 61 74 63 68 20 74 |ion will| match t|
|00003140| 68 65 20 76 61 6c 75 65 | 20 6f 66 20 74 68 65 20 |he value| of the |
|00003150| 6c 61 73 74 20 4d 4f 44 | 55 4c 45 20 73 74 61 74 |last MOD|ULE stat|
|00003160| 65 6d 65 6e 74 20 00 00 | 00 84 00 00 05 7c 00 00 |ement ..|.....|..|
|00003170| 00 9c 95 07 a9 6e dc ff | 89 9d dc ff 20 22 00 00 |.....n..|.... "..|
|00003180| 69 6e 20 74 68 65 20 58 | 53 20 73 6f 75 72 63 65 |in the X|S source|
|00003190| 20 66 69 6c 65 73 2e 20 | 20 54 68 65 20 76 61 6c | files. | The val|
|000031a0| 75 65 20 6f 66 20 4d 4f | 44 55 4c 45 20 73 68 6f |ue of MO|DULE sho|
|000031b0| 75 6c 64 20 61 6c 77 61 | 79 73 20 72 65 6d 61 69 |uld alwa|ys remai|
|000031c0| 6e 20 63 6f 6e 73 74 61 | 6e 74 20 77 69 74 68 69 |n consta|nt withi|
|000031d0| 6e 20 74 68 65 20 73 61 | 6d 65 20 58 53 20 66 69 |n the sa|me XS fi|
|000031e0| 6c 65 2c 20 00 7c 00 00 | 25 38 00 00 40 e8 f7 01 |le, .|..|%8..@...|
|000031f0| 82 36 dc ff 62 65 dc ff | 20 22 00 00 74 68 6f 75 |.6..be..| "..thou|
|00003200| 67 68 20 74 68 69 73 20 | 69 73 20 6e 6f 74 20 72 |gh this |is not r|
|00003210| 65 71 75 69 72 65 64 2e | 0d 00 00 00 00 38 00 00 |equired.|.....8..|
|00003220| a5 9c 00 00 40 90 4d 07 | ab c7 db ff 8b f6 db ff |....@.M.|........|
|00003230| 20 22 00 00 54 68 65 20 | 66 6f 6c 6c 6f 77 69 6e | "..The |followin|
|00003240| 67 20 65 78 61 6d 70 6c | 65 20 77 69 6c 6c 20 73 |g exampl|e will s|
|00003250| 74 61 72 74 20 74 68 65 | 20 58 53 20 63 6f 64 65 |tart the| XS code|
|00003260| 20 61 6e 64 20 77 69 6c | 6c 20 70 6c 61 63 65 20 | and wil|l place |
|00003270| 61 6c 6c 20 66 75 6e 63 | 74 69 6f 6e 73 20 69 6e |all func|tions in|
|00003280| 20 61 20 70 61 63 6b 61 | 67 65 20 6e 61 6d 65 64 | a packa|ge named|
|00003290| 20 52 50 43 2e 0d 07 74 | 12 92 a1 00 12 92 a1 00 | RPC...t|........|
|000032a0| 00 00 00 00 07 20 74 79 | 0c 93 a1 00 12 92 a1 00 |..... ty|........|
|000032b0| 0c 93 a1 00 00 00 00 00 | 00 9c 00 00 a5 50 00 00 |........|.....P..|
|000032c0| 40 40 19 01 a4 60 db ff | b4 87 db ff 70 1a 00 00 |@@...`..|....p...|
|000032d0| 4d 4f 44 55 4c 45 20 3d | 20 52 50 43 0d 08 74 74 |MODULE =| RPC..tt|
|000032e0| 0c 94 a1 00 12 92 a1 00 | 00 00 00 00 08 70 29 0d |........|.....p).|
|000032f0| 12 00 00 00 00 00 00 00 | 07 20 2a 68 18 95 a1 00 |........|. *h....|
|00003300| 18 95 a1 00 00 00 00 00 | 00 50 00 00 a5 34 00 00 |........|.P...4..|
|00003310| 40 00 00 00 14 4c db ff | d4 58 db ff 00 00 00 00 |@....L..|.X......|
|00003320| 0d 08 20 20 18 96 a1 00 | 00 00 00 00 07 5f 73 65 |.. ....|....._se|
|00003330| 0a 97 a1 00 0a 97 a1 00 | 00 00 00 00 00 34 00 00 |........|.....4..|
|00003340| a5 38 00 00 40 bc 55 02 | 74 eb da ff 24 22 db ff |.8..@.U.|t...$"..|
|00003350| 18 2b 00 00 54 68 65 20 | 50 41 43 4b 41 47 45 20 |.+..The |PACKAGE |
|00003360| 4b 65 79 77 6f 72 64 0d | 08 d4 a1 00 0a 98 a1 00 |Keyword.|........|
|00003370| 00 00 00 00 00 38 00 00 | 05 7c 00 00 00 7c c7 07 |.....8..|.|...|..|
|00003380| 3f 96 da ff 1f c5 da ff | 20 22 00 00 57 68 65 6e |?.......| "..When|
|00003390| 20 66 75 6e 63 74 69 6f | 6e 73 20 77 69 74 68 69 | functio|ns withi|
|000033a0| 6e 20 61 6e 20 58 53 20 | 73 6f 75 72 63 65 20 66 |n an XS |source f|
|000033b0| 69 6c 65 20 6d 75 73 74 | 20 62 65 20 73 65 70 61 |ile must| be sepa|
|000033c0| 72 61 74 65 64 20 69 6e | 74 6f 20 70 61 63 6b 61 |rated in|to packa|
|000033d0| 67 65 73 20 74 68 65 20 | 50 41 43 4b 41 47 45 20 |ges the |PACKAGE |
|000033e0| 6b 65 79 77 6f 72 64 20 | 73 68 6f 75 6c 64 20 00 |keyword |should .|
|000033f0| 00 7c 00 00 05 7c 00 00 | 00 08 93 07 18 5e da ff |.|...|..|.....^..|
|00003400| f8 8c da ff 20 22 00 00 | 62 65 20 75 73 65 64 2e |.... "..|be used.|
|00003410| 20 20 54 68 69 73 20 6b | 65 79 77 6f 72 64 20 69 | This k|eyword i|
|00003420| 73 20 75 73 65 64 20 77 | 69 74 68 20 74 68 65 20 |s used w|ith the |
|00003430| 4d 4f 44 55 4c 45 20 6b | 65 79 77 6f 72 64 20 61 |MODULE k|eyword a|
|00003440| 6e 64 20 6d 75 73 74 20 | 66 6f 6c 6c 6f 77 20 69 |nd must |follow i|
|00003450| 6d 6d 65 64 69 61 74 65 | 6c 79 20 61 66 74 65 72 |mmediate|ly after|
|00003460| 20 69 74 20 77 68 65 6e | 20 00 00 00 00 7c 00 00 | it when| ....|..|
|00003470| a5 40 00 00 40 a4 61 00 | f1 25 da ff d1 54 da ff |.@..@.a.|.%...T..|
|00003480| 20 22 00 00 75 73 65 64 | 2e 0d 07 55 12 99 a1 00 | "..used|...U....|
|00003490| 12 99 a1 00 00 00 00 00 | 07 66 75 6e 0c 9a a1 00 |........|.fun....|
|000034a0| 12 99 a1 00 0c 9a a1 00 | 00 00 00 00 00 40 00 00 |........|.....@..|
|000034b0| 01 10 00 00 41 d0 78 02 | 00 00 00 00 00 10 00 00 |....A.x.|........|
|000034c0| 02 1c 00 00 9c 05 00 00 | 00 00 00 00 12 99 a1 00 |........|........|
|000034d0| 0c 9a a1 00 00 00 00 00 | 00 1c 00 00 a5 6c 00 00 |........|.....l..|
|000034e0| 40 d0 78 02 3d 4d d8 ff | 4d 74 d8 ff 70 1a 00 00 |@.x.=M..|Mt..p...|
|000034f0| 16 00 00 00 b0 fc 07 00 | 00 00 00 00 4d 4f 44 55 |........|....MODU|
|00003500| 4c 45 20 3d 20 52 50 43 | 20 20 50 41 43 4b 41 47 |LE = RPC| PACKAG|
|00003510| 45 20 3d 20 52 50 43 0d | 08 6e 20 50 0c 9b a1 00 |E = RPC.|.n P....|
|00003520| 12 99 a1 00 00 00 00 00 | 08 43 20 6c 12 00 00 00 |........|.C l....|
|00003530| 00 00 00 00 07 69 63 68 | 18 9c a1 00 18 9c a1 00 |.....ich|........|
|00003540| 00 00 00 00 00 6c 00 00 | a5 48 00 00 40 00 00 00 |.....l..|.H..@...|
|00003550| ad 38 d8 ff 6d 45 d8 ff | 00 00 00 00 0d 08 69 6e |.8..mE..|......in|
|00003560| 18 9d a1 00 00 00 00 00 | 07 73 20 63 12 9e a1 00 |........|.s c....|
|00003570| 12 9e a1 00 00 00 00 00 | 07 74 68 65 0c 9f a1 00 |........|.the....|
|00003580| 12 9e a1 00 0c 9f a1 00 | 00 00 00 00 00 48 00 00 |........|.....H..|
|00003590| a5 5c 00 00 40 60 61 02 | ad e7 d7 ff bd 0e d8 ff |.\..@`a.|........|
|000035a0| 70 1a 00 00 5b 20 58 53 | 20 63 6f 64 65 20 69 6e |p...[ XS| code in|
|000035b0| 20 70 61 63 6b 61 67 65 | 20 52 50 43 20 5d 0d 08 | package| RPC ]..|
|000035c0| 0c a0 a1 00 12 9e a1 00 | 00 00 00 00 08 53 55 42 |........|.....SUB|
|000035d0| 12 00 00 00 00 00 00 00 | 07 00 00 00 18 a1 a1 00 |........|........|
|000035e0| 18 a1 a1 00 00 00 00 00 | 00 5c 00 00 a5 48 00 00 |........|.\...H..|
|000035f0| 40 00 00 00 1d d3 d7 ff | dd df d7 ff 00 00 00 00 |@.......|........|
|00003600| 0d 08 69 73 18 a2 a1 00 | 00 00 00 00 07 20 63 6f |..is....|..... co|
|00003610| 12 a3 a1 00 12 a3 a1 00 | 00 00 00 00 07 65 20 50 |........|.....e P|
|00003620| 0c a4 a1 00 12 a3 a1 00 | 0c a4 a1 00 00 00 00 00 |........|........|
|00003630| 00 48 00 00 a5 60 00 00 | 40 40 90 02 1d 82 d7 ff |.H...`..|@@......|
|00003640| 2d a9 d7 ff 70 1a 00 00 | 4d 4f 44 55 4c 45 20 3d |-...p...|MODULE =|
|00003650| 20 52 50 43 20 20 50 41 | 43 4b 41 47 45 20 3d 20 | RPC PA|CKAGE = |
|00003660| 52 50 43 42 0d 08 75 62 | 0c a5 a1 00 12 a3 a1 00 |RPCB..ub|........|
|00003670| 00 00 00 00 08 20 20 54 | 12 00 00 00 00 00 00 00 |..... T|........|
|00003680| 07 6c 65 72 18 a6 a1 00 | 18 a6 a1 00 00 00 00 00 |.ler....|........|
|00003690| 00 60 00 00 a5 48 00 00 | 40 00 00 00 8d 6d d7 ff |.`...H..|@....m..|
|000036a0| 4d 7a d7 ff 00 00 00 00 | 0d 08 6f 20 18 a7 a1 00 |Mz......|..o ....|
|000036b0| 00 00 00 00 07 55 42 2c | 12 a8 a1 00 12 a8 a1 00 |.....UB,|........|
|000036c0| 00 00 00 00 07 6c 6c 79 | 0c a9 a1 00 12 a8 a1 00 |.....lly|........|
|000036d0| 0c a9 a1 00 00 00 00 00 | 00 48 00 00 a5 60 00 00 |........|.H...`..|
|000036e0| 40 d0 78 02 8d 1c d7 ff | 9d 43 d7 ff 70 1a 00 00 |@.x.....|.C..p...|
|000036f0| 5b 20 58 53 20 63 6f 64 | 65 20 69 6e 20 70 61 63 |[ XS cod|e in pac|
|00003700| 6b 61 67 65 20 52 50 43 | 42 20 5d 0d 08 65 20 6e |kage RPC|B ]..e n|
|00003710| 0c aa a1 00 12 a8 a1 00 | 00 00 00 00 08 65 74 20 |........|.....et |
|00003720| 12 00 00 00 00 00 00 00 | 07 73 73 20 18 ab a1 00 |........|.ss ....|
|00003730| 18 ab a1 00 00 00 00 00 | 00 60 00 00 a5 48 00 00 |........|.`...H..|
|00003740| 40 00 00 00 fd 07 d7 ff | bd 14 d7 ff 00 00 00 00 |@.......|........|
|00003750| 0d 08 a1 00 18 ac a1 00 | 00 00 00 00 07 61 70 73 |........|.....aps|
|00003760| 12 ad a1 00 12 ad a1 00 | 00 00 00 00 07 74 6f 20 |........|.....to |
|00003770| 0c ae a1 00 12 ad a1 00 | 0c ae a1 00 00 00 00 00 |........|........|
|00003780| 00 48 00 00 a5 60 00 00 | 40 d0 78 02 fd b6 d6 ff |.H...`..|@.x.....|
|00003790| 0d de d6 ff 70 1a 00 00 | 4d 4f 44 55 4c 45 20 3d |....p...|MODULE =|
|000037a0| 20 52 50 43 20 20 50 41 | 43 4b 41 47 45 20 3d 20 | RPC PA|CKAGE = |
|000037b0| 52 50 43 0d 08 65 73 2e | 0c af a1 00 12 ad a1 00 |RPC..es.|........|
|000037c0| 00 00 00 00 08 20 74 79 | 12 00 00 00 00 00 00 00 |..... ty|........|
|000037d0| 07 64 6c 65 18 b0 a1 00 | 18 b0 a1 00 00 00 00 00 |.dle....|........|
|000037e0| 00 60 00 00 a5 48 00 00 | 40 00 00 00 6d a2 d6 ff |.`...H..|@...m...|
|000037f0| 2d af d6 ff 00 00 00 00 | 0d 08 79 70 18 b1 a1 00 |-.......|..yp....|
|00003800| 00 00 00 00 07 20 62 65 | 12 b2 a1 00 12 b2 a1 00 |..... be|........|
|00003810| 00 00 00 00 07 61 6e 64 | 0c b3 a1 00 12 b2 a1 00 |.....and|........|
|00003820| 0c b3 a1 00 00 00 00 00 | 00 48 00 00 a5 5c 00 00 |........|.H...\..|
|00003830| 40 60 61 02 6d 51 d6 ff | 7d 78 d6 ff 70 1a 00 00 |@`a.mQ..|}x..p...|
|00003840| 5b 20 58 53 20 63 6f 64 | 65 20 69 6e 20 70 61 63 |[ XS cod|e in pac|
|00003850| 6b 61 67 65 20 52 50 43 | 20 5d 0d 08 0c b4 a1 00 |kage RPC| ]......|
|00003860| 12 b2 a1 00 00 00 00 00 | 08 21 a1 00 12 00 00 00 |........|.!......|
|00003870| 00 00 00 00 07 65 72 6c | 18 b5 a1 00 18 b5 a1 00 |.....erl|........|
|00003880| 00 00 00 00 00 5c 00 00 | a5 24 00 00 40 00 00 00 |.....\..|.$..@...|
|00003890| dd 3c d6 ff 9d 49 d6 ff | 00 00 00 00 0d 08 20 77 |.<...I..|...... w|
|000038a0| 18 b6 a1 00 00 00 00 00 | 00 24 00 00 05 80 00 00 |........|.$......|
|000038b0| 00 4c af 07 0d e4 d5 ff | ed 12 d6 ff 20 22 00 00 |.L......|.... "..|
|000038c0| 41 6c 74 68 6f 75 67 68 | 20 74 68 69 73 20 6b 65 |Although| this ke|
|000038d0| 79 77 6f 72 64 20 69 73 | 20 6f 70 74 69 6f 6e 61 |yword is| optiona|
|000038e0| 6c 20 61 6e 64 20 69 6e | 20 73 6f 6d 65 20 63 61 |l and in| some ca|
|000038f0| 73 65 73 20 70 72 6f 76 | 69 64 65 73 20 72 65 64 |ses prov|ides red|
|00003900| 75 6e 64 61 6e 74 20 69 | 6e 66 6f 72 6d 61 74 69 |undant i|nformati|
|00003910| 6f 6e 20 69 74 20 73 68 | 6f 75 6c 64 20 61 6c 77 |on it sh|ould alw|
|00003920| 61 79 73 20 62 65 20 00 | 00 80 00 00 a5 74 00 00 |ays be .|.....t..|
|00003930| 40 f4 c9 05 e6 ab d5 ff | c6 da d5 ff 20 22 00 00 |@.......|.... "..|
|00003940| 75 73 65 64 2e 20 20 54 | 68 69 73 20 6b 65 79 77 |used. T|his keyw|
|00003950| 6f 72 64 20 77 69 6c 6c | 20 65 6e 73 75 72 65 20 |ord will| ensure |
|00003960| 74 68 61 74 20 74 68 65 | 20 58 53 55 42 73 20 61 |that the| XSUBs a|
|00003970| 70 70 65 61 72 20 69 6e | 20 74 68 65 20 64 65 73 |ppear in| the des|
|00003980| 69 72 65 64 20 70 61 63 | 6b 61 67 65 2e 0d 07 74 |ired pac|kage...t|
|00003990| 0a b7 a1 00 0a b7 a1 00 | 00 00 00 00 00 74 00 00 |........|.....t..|
|000039a0| a5 34 00 00 40 e6 16 02 | 3f 35 d5 ff ef 6b d5 ff |.4..@...|?5...k..|
|000039b0| 18 2b 00 00 54 68 65 20 | 50 52 45 46 49 58 20 4b |.+..The |PREFIX K|
|000039c0| 65 79 77 6f 72 64 0d 08 | 0a b8 a1 00 00 00 00 00 |eyword..|........|
|000039d0| 00 34 00 00 05 80 00 00 | 00 20 e7 07 0a e0 d4 ff |.4......|. ......|
|000039e0| ea 0e d5 ff 20 22 00 00 | 54 68 65 20 50 52 45 46 |.... "..|The PREF|
|000039f0| 49 58 20 6b 65 79 77 6f | 72 64 20 64 65 73 69 67 |IX keywo|rd desig|
|00003a00| 6e 61 74 65 73 20 70 72 | 65 66 69 78 65 73 20 77 |nates pr|efixes w|
|00003a10| 68 69 63 68 20 73 68 6f | 75 6c 64 20 62 65 20 72 |hich sho|uld be r|
|00003a20| 65 6d 6f 76 65 64 20 66 | 72 6f 6d 20 74 68 65 20 |emoved f|rom the |
|00003a30| 50 65 72 6c 20 66 75 6e | 63 74 69 6f 6e 20 6e 61 |Perl fun|ction na|
|00003a40| 6d 65 73 2e 20 20 49 66 | 20 74 68 65 20 43 20 00 |mes. If| the C .|
|00003a50| 00 80 00 00 85 b8 00 00 | 00 f4 4c 07 e3 a7 d4 ff |........|..L.....|
|00003a60| c3 d6 d4 ff 20 22 00 00 | 66 75 6e 63 74 69 6f 6e |.... "..|function|
|00003a70| 20 69 73 20 07 00 00 00 | 0e b9 a1 00 0e b9 a1 00 | is ....|........|
|00003a80| 00 00 00 00 72 70 63 62 | 5f 67 65 74 74 69 6d 65 |....rpcb|_gettime|
|00003a90| 28 29 08 68 0e ba a1 00 | 00 00 00 00 20 61 6e 64 |().h....|.... and|
|00003aa0| 20 74 68 65 20 50 52 45 | 46 49 58 20 76 61 6c 75 | the PRE|FIX valu|
|00003ab0| 65 20 69 73 20 07 a1 00 | 0e bb a1 00 0e bb a1 00 |e is ...|........|
|00003ac0| 00 00 00 00 72 70 63 62 | 5f 08 05 05 0e bc a1 00 |....rpcb|_.......|
|00003ad0| 00 00 00 00 20 74 68 65 | 6e 20 50 65 72 6c 20 77 |.... the|n Perl w|
|00003ae0| 69 6c 6c 20 73 65 65 20 | 74 68 69 73 20 66 75 6e |ill see |this fun|
|00003af0| 63 74 69 6f 6e 20 61 73 | 20 07 69 6c 0e bd a1 00 |ction as| .il....|
|00003b00| 0e bd a1 00 00 00 00 00 | 00 b8 00 00 a5 30 00 00 |........|.....0..|
|00003b10| 40 d8 08 01 bc 6f d4 ff | 9c 9e d4 ff ba 1f 00 00 |@....o..|........|
|00003b20| 67 65 74 74 69 6d 65 28 | 29 08 a1 00 0e be a1 00 |gettime(|).......|
|00003b30| 00 00 00 00 2e 0d 00 00 | 00 30 00 00 05 78 00 00 |........|.0...x..|
|00003b40| 00 98 b7 07 e5 00 d4 ff | c5 2f d4 ff 20 22 00 00 |........|./.. "..|
|00003b50| 54 68 69 73 20 6b 65 79 | 77 6f 72 64 20 73 68 6f |This key|word sho|
|00003b60| 75 6c 64 20 66 6f 6c 6c | 6f 77 20 74 68 65 20 50 |uld foll|ow the P|
|00003b70| 41 43 4b 41 47 45 20 6b | 65 79 77 6f 72 64 20 77 |ACKAGE k|eyword w|
|00003b80| 68 65 6e 20 75 73 65 64 | 2e 20 49 66 20 50 41 43 |hen used|. If PAC|
|00003b90| 4b 41 47 45 20 69 73 20 | 6e 6f 74 20 75 73 65 64 |KAGE is |not used|
|00003ba0| 20 74 68 65 6e 20 50 52 | 45 46 49 58 20 00 00 00 | then PR|EFIX ...|
|00003bb0| 00 78 00 00 a5 5c 00 00 | 40 c8 d7 02 be c8 d3 ff |.x...\..|@.......|
|00003bc0| 9e f7 d3 ff 20 22 00 00 | 73 68 6f 75 6c 64 20 66 |.... "..|should f|
|00003bd0| 6f 6c 6c 6f 77 20 74 68 | 65 20 4d 4f 44 55 4c 45 |ollow th|e MODULE|
|00003be0| 20 6b 65 79 77 6f 72 64 | 2e 0d 07 69 12 bf a1 00 | keyword|...i....|
|00003bf0| 12 bf a1 00 00 00 00 00 | 07 6f 66 66 0c c0 a1 00 |........|.off....|
|00003c00| 12 bf a1 00 0c c0 a1 00 | 00 00 00 00 00 5c 00 00 |........|.....\..|
|00003c10| a5 60 00 00 40 d0 78 02 | b7 61 d3 ff c7 88 d3 ff |.`..@.x.|.a......|
|00003c20| 70 1a 00 00 4d 4f 44 55 | 4c 45 20 3d 20 52 50 43 |p...MODU|LE = RPC|
|00003c30| 20 20 50 52 45 46 49 58 | 20 3d 20 72 70 63 5f 0d | PREFIX| = rpc_.|
|00003c40| 08 42 20 77 0c c1 a1 00 | 12 bf a1 00 00 00 00 00 |.B w....|........|
|00003c50| 08 72 6f 6d 12 00 00 00 | 00 00 00 00 07 68 20 74 |.rom....|.....h t|
|00003c60| 18 c2 a1 00 18 c2 a1 00 | 00 00 00 00 00 60 00 00 |........|.....`..|
|00003c70| a5 48 00 00 40 00 00 00 | 27 4d d3 ff e7 59 d3 ff |.H..@...|'M...Y..|
|00003c80| 00 00 00 00 0d 08 6d 65 | 18 c3 a1 00 00 00 00 00 |......me|........|
|00003c90| 07 65 73 20 12 c4 a1 00 | 12 c4 a1 00 00 00 00 00 |.es ....|........|
|00003ca0| 07 74 68 65 0c c5 a1 00 | 12 c4 a1 00 0c c5 a1 00 |.the....|........|
|00003cb0| 00 00 00 00 00 48 00 00 | a5 70 00 00 40 40 07 04 |.....H..|.p..@@..|
|00003cc0| 27 fc d2 ff 37 23 d3 ff | 70 1a 00 00 4d 4f 44 55 |'...7#..|p...MODU|
|00003cd0| 4c 45 20 3d 20 52 50 43 | 20 20 50 41 43 4b 41 47 |LE = RPC| PACKAG|
|00003ce0| 45 20 3d 20 52 50 43 42 | 20 20 50 52 45 46 49 58 |E = RPCB| PREFIX|
|00003cf0| 20 3d 20 72 70 63 62 5f | 0d 08 74 74 0c c6 a1 00 | = rpcb_|..tt....|
|00003d00| 12 c4 a1 00 00 00 00 00 | 08 73 74 22 12 00 00 00 |........|.st"....|
|00003d10| 00 00 00 00 07 29 3b 0d | 18 c7 a1 00 18 c7 a1 00 |.....);.|........|
|00003d20| 00 00 00 00 00 70 00 00 | a5 34 00 00 40 00 00 00 |.....p..|.4..@...|
|00003d30| 97 e7 d2 ff 57 f4 d2 ff | 00 00 00 00 0d 08 a1 00 |....W...|........|
|00003d40| 18 c8 a1 00 00 00 00 00 | 07 32 a1 00 0a c9 a1 00 |........|.2......|
|00003d50| 0a c9 a1 00 00 00 00 00 | 00 34 00 00 a5 38 00 00 |........|.4...8..|
|00003d60| 40 52 3b 02 f7 86 d2 ff | a7 bd d2 ff 18 2b 00 00 |@R;.....|.....+..|
|00003d70| 54 68 65 20 4f 55 54 50 | 55 54 3a 20 4b 65 79 77 |The OUTP|UT: Keyw|
|00003d80| 6f 72 64 0d 08 2c 20 77 | 0a ca a1 00 00 00 00 00 |ord.., w|........|
|00003d90| 00 38 00 00 05 7c 00 00 | 00 dc 97 07 c2 31 d2 ff |.8...|..|.....1..|
|00003da0| a2 60 d2 ff 20 22 00 00 | 54 68 65 20 4f 55 54 50 |.`.. "..|The OUTP|
|00003db0| 55 54 3a 20 6b 65 79 77 | 6f 72 64 20 69 6e 64 69 |UT: keyw|ord indi|
|00003dc0| 63 61 74 65 73 20 74 68 | 61 74 20 63 65 72 74 61 |cates th|at certa|
|00003dd0| 69 6e 20 66 75 6e 63 74 | 69 6f 6e 20 70 61 72 61 |in funct|ion para|
|00003de0| 6d 65 74 65 72 73 20 73 | 68 6f 75 6c 64 20 62 65 |meters s|hould be|
|00003df0| 20 75 70 64 61 74 65 64 | 20 28 6e 65 77 20 76 61 | updated| (new va|
|00003e00| 6c 75 65 73 20 6d 61 64 | 65 20 00 00 00 7c 00 00 |lues mad|e ...|..|
|00003e10| 05 80 00 00 00 ec 75 07 | 9b f9 d1 ff 7b 28 d2 ff |......u.|....{(..|
|00003e20| 20 22 00 00 76 69 73 69 | 62 6c 65 20 74 6f 20 50 | "..visi|ble to P|
|00003e30| 65 72 6c 29 20 77 68 65 | 6e 20 74 68 65 20 58 53 |erl) whe|n the XS|
|00003e40| 55 42 20 74 65 72 6d 69 | 6e 61 74 65 73 20 6f 72 |UB termi|nates or|
|00003e50| 20 74 68 61 74 20 63 65 | 72 74 61 69 6e 20 76 61 | that ce|rtain va|
|00003e60| 6c 75 65 73 20 73 68 6f | 75 6c 64 20 62 65 20 72 |lues sho|uld be r|
|00003e70| 65 74 75 72 6e 65 64 20 | 74 6f 20 74 68 65 20 63 |eturned |to the c|
|00003e80| 61 6c 6c 69 6e 67 20 50 | 65 72 6c 20 00 80 00 00 |alling P|erl ....|
|00003e90| 05 80 00 00 00 ec 93 07 | 74 c1 d1 ff 54 f0 d1 ff |........|t...T...|
|00003ea0| 20 22 00 00 66 75 6e 63 | 74 69 6f 6e 2e 20 20 46 | "..func|tion. F|
|00003eb0| 6f 72 20 73 69 6d 70 6c | 65 20 66 75 6e 63 74 69 |or simpl|e functi|
|00003ec0| 6f 6e 73 2c 20 73 75 63 | 68 20 61 73 20 74 68 65 |ons, suc|h as the|
|00003ed0| 20 73 69 6e 28 29 20 66 | 75 6e 63 74 69 6f 6e 20 | sin() f|unction |
|00003ee0| 61 62 6f 76 65 2c 20 74 | 68 65 20 52 45 54 56 41 |above, t|he RETVA|
|00003ef0| 4c 20 76 61 72 69 61 62 | 6c 65 20 69 73 20 61 75 |L variab|le is au|
|00003f00| 74 6f 6d 61 74 69 63 61 | 6c 6c 79 20 00 80 00 00 |tomatica|lly ....|
|00003f10| 85 9c 00 00 00 44 e7 07 | 4d 89 d1 ff 2d b8 d1 ff |.....D..|M...-...|
|00003f20| 20 22 00 00 64 65 73 69 | 67 6e 61 74 65 64 20 61 | "..desi|gnated a|
|00003f30| 73 20 61 6e 20 6f 75 74 | 70 75 74 20 76 61 6c 75 |s an out|put valu|
|00003f40| 65 2e 20 20 49 6e 20 6d | 6f 72 65 20 63 6f 6d 70 |e. In m|ore comp|
|00003f50| 6c 65 78 20 66 75 6e 63 | 74 69 6f 6e 73 20 74 68 |lex func|tions th|
|00003f60| 65 20 07 20 10 cb a1 00 | 10 cb a1 00 00 00 00 00 |e . ....|........|
|00003f70| 78 73 75 62 70 70 08 6e | 10 00 00 00 00 00 00 00 |xsubpp.n|........|
|00003f80| 20 63 6f 6d 70 69 6c 65 | 72 20 77 69 6c 6c 20 6e | compile|r will n|
|00003f90| 65 65 64 20 68 65 6c 70 | 20 74 6f 20 64 65 74 65 |eed help| to dete|
|00003fa0| 72 6d 69 6e 65 20 00 00 | 00 9c 00 00 25 40 00 00 |rmine ..|....%@..|
|00003fb0| 40 a4 b0 02 26 51 d1 ff | 06 80 d1 ff 20 22 00 00 |@...&Q..|.... "..|
|00003fc0| 77 68 69 63 68 20 76 61 | 72 69 61 62 6c 65 73 20 |which va|riables |
|00003fd0| 61 72 65 20 6f 75 74 70 | 75 74 20 76 61 72 69 61 |are outp|ut varia|
|00003fe0| 62 6c 65 73 2e 0d 00 00 | 00 40 00 00 05 78 00 00 |bles....|.@...x..|
|00003ff0| 00 64 94 07 4f e2 d0 ff | 2f 11 d1 ff 20 22 00 00 |.d..O...|/... "..|
|00004000| 54 68 69 73 20 6b 65 79 | 77 6f 72 64 20 77 69 6c |This key|word wil|
|00004010| 6c 20 6e 6f 72 6d 61 6c | 6c 79 20 62 65 20 75 73 |l normal|ly be us|
|00004020| 65 64 20 74 6f 20 63 6f | 6d 70 6c 65 6d 65 6e 74 |ed to co|mplement|
|00004030| 20 74 68 65 20 43 4f 44 | 45 3a 20 20 6b 65 79 77 | the COD|E: keyw|
|00004040| 6f 72 64 2e 20 54 68 65 | 20 52 45 54 56 41 4c 20 |ord. The| RETVAL |
|00004050| 76 61 72 69 61 62 6c 65 | 20 69 73 20 6e 6f 74 20 |variable| is not |
|00004060| 00 78 00 00 05 80 00 00 | 00 c4 cd 07 28 aa d0 ff |.x......|....(...|
|00004070| 08 d9 d0 ff 20 22 00 00 | 72 65 63 6f 67 6e 69 7a |.... "..|recogniz|
|00004080| 65 64 20 61 73 20 61 6e | 20 6f 75 74 70 75 74 20 |ed as an| output |
|00004090| 76 61 72 69 61 62 6c 65 | 20 77 68 65 6e 20 74 68 |variable| when th|
|000040a0| 65 20 43 4f 44 45 3a 20 | 6b 65 79 77 6f 72 64 20 |e CODE: |keyword |
|000040b0| 69 73 20 70 72 65 73 65 | 6e 74 2e 20 20 54 68 65 |is prese|nt. The|
|000040c0| 20 4f 55 54 50 55 54 3a | 20 20 6b 65 79 77 6f 72 | OUTPUT:| keywor|
|000040d0| 64 20 69 73 20 75 73 65 | 64 20 69 6e 20 00 00 00 |d is use|d in ...|
|000040e0| 00 80 00 00 25 68 00 00 | 40 50 7a 05 01 72 d0 ff |....%h..|@Pz..r..|
|000040f0| e1 a0 d0 ff 20 22 00 00 | 74 68 69 73 20 73 69 74 |.... "..|this sit|
|00004100| 75 61 74 69 6f 6e 20 74 | 6f 20 74 65 6c 6c 20 74 |uation t|o tell t|
|00004110| 68 65 20 63 6f 6d 70 69 | 6c 65 72 20 74 68 61 74 |he compi|ler that|
|00004120| 20 52 45 54 56 41 4c 20 | 72 65 61 6c 6c 79 20 69 | RETVAL |really i|
|00004130| 73 20 61 6e 20 6f 75 74 | 70 75 74 20 76 61 72 69 |s an out|put vari|
|00004140| 61 62 6c 65 2e 0d 00 00 | 00 68 00 00 05 80 00 00 |able....|.h......|
|00004150| 00 44 9c 07 2a 03 d0 ff | 0a 32 d0 ff 20 22 00 00 |.D..*...|.2.. "..|
|00004160| 54 68 65 20 4f 55 54 50 | 55 54 3a 20 6b 65 79 77 |The OUTP|UT: keyw|
|00004170| 6f 72 64 20 63 61 6e 20 | 61 6c 73 6f 20 62 65 20 |ord can |also be |
|00004180| 75 73 65 64 20 74 6f 20 | 69 6e 64 69 63 61 74 65 |used to |indicate|
|00004190| 20 74 68 61 74 20 66 75 | 6e 63 74 69 6f 6e 20 70 | that fu|nction p|
|000041a0| 61 72 61 6d 65 74 65 72 | 73 20 61 72 65 20 6f 75 |arameter|s are ou|
|000041b0| 74 70 75 74 20 76 61 72 | 69 61 62 6c 65 73 2e 20 |tput var|iables. |
|000041c0| 20 54 68 69 73 20 00 00 | 00 80 00 00 05 80 00 00 | This ..|........|
|000041d0| 00 2c d2 07 03 cb cf ff | e3 f9 cf ff 20 22 00 00 |.,......|.... "..|
|000041e0| 6d 61 79 20 62 65 20 6e | 65 63 65 73 73 61 72 79 |may be n|ecessary|
|000041f0| 20 77 68 65 6e 20 61 20 | 70 61 72 61 6d 65 74 65 | when a |paramete|
|00004200| 72 20 68 61 73 20 62 65 | 65 6e 20 6d 6f 64 69 66 |r has be|en modif|
|00004210| 69 65 64 20 77 69 74 68 | 69 6e 20 74 68 65 20 66 |ied with|in the f|
|00004220| 75 6e 63 74 69 6f 6e 20 | 61 6e 64 20 74 68 65 20 |unction |and the |
|00004230| 70 72 6f 67 72 61 6d 6d | 65 72 20 77 6f 75 6c 64 |programm|er would|
|00004240| 20 6c 69 6b 65 20 00 00 | 00 80 00 00 a5 58 00 00 | like ..|.....X..|
|00004250| 40 b0 26 02 dc 92 cf ff | bc c1 cf ff 20 22 00 00 |@.&.....|.... "..|
|00004260| 74 68 65 20 75 70 64 61 | 74 65 20 74 6f 20 62 65 |the upda|te to be|
|00004270| 20 73 65 65 6e 20 62 79 | 20 50 65 72 6c 2e 0d 07 | seen by| Perl...|
|00004280| 12 cc a1 00 12 cc a1 00 | 00 00 00 00 07 68 65 20 |........|.....he |
|00004290| 0c cd a1 00 12 cc a1 00 | 0c cd a1 00 00 00 00 00 |........|........|
|000042a0| 00 58 00 00 25 20 00 00 | 40 a0 8c 00 d5 2b cf ff |.X..% ..|@....+..|
|000042b0| e5 52 cf ff 70 1a 00 00 | 62 6f 6f 6c 5f 74 0d 00 |.R..p...|bool_t..|
|000042c0| 00 20 00 00 25 34 00 00 | 40 80 32 02 f5 fc ce ff |. ..%4..|@.2.....|
|000042d0| 05 24 cf ff 70 1a 00 00 | 72 70 63 62 5f 67 65 74 |.$..p...|rpcb_get|
|000042e0| 74 69 6d 65 28 68 6f 73 | 74 2c 74 69 6d 65 70 29 |time(hos|t,timep)|
|000042f0| 0d 00 00 00 00 34 00 00 | 25 28 00 00 40 90 5f 01 |.....4..|%(..@._.|
|00004300| 15 ce ce ff 25 f5 ce ff | 70 1a 00 00 20 20 20 20 |....%...|p... |
|00004310| 20 63 68 61 72 20 2a 68 | 6f 73 74 0d 00 28 00 00 | char *h|ost..(..|
|00004320| 25 2c 00 00 40 e0 a5 01 | 35 9f ce ff 45 c6 ce ff |%,..@...|5...E...|
|00004330| 70 1a 00 00 20 20 20 20 | 20 74 69 6d 65 5f 74 20 |p... | time_t |
|00004340| 26 74 69 6d 65 70 0d 00 | 00 2c 00 00 25 28 00 00 |&timep..|.,..%(..|
|00004350| 40 40 19 01 55 70 ce ff | 65 97 ce ff 70 1a 00 00 |@@..Up..|e...p...|
|00004360| 20 20 20 20 20 4f 55 54 | 50 55 54 3a 0d 00 00 00 | OUT|PUT:....|
|00004370| 00 28 00 00 a5 4c 00 00 | 40 60 ea 00 75 41 ce ff |.(...L..|@`..uA..|
|00004380| 85 68 ce ff 70 1a 00 00 | 20 20 20 20 20 74 69 6d |.h..p...| tim|
|00004390| 65 70 0d 08 0c ce a1 00 | 12 cc a1 00 00 00 00 00 |ep......|........|
|000043a0| 08 50 43 3b 12 00 00 00 | 00 00 00 00 07 4a a1 00 |.PC;....|.....J..|
|000043b0| 18 cf a1 00 18 cf a1 00 | 00 00 00 00 00 4c 00 00 |........|.....L..|
|000043c0| a5 24 00 00 40 00 00 00 | e5 2c ce ff a5 39 ce ff |.$..@...|.,...9..|
|000043d0| 00 00 00 00 0d 08 a1 00 | 18 d0 a1 00 00 00 00 00 |........|........|
|000043e0| 00 24 00 00 05 7c 00 00 | 00 18 83 07 15 d4 cd ff |.$...|..|........|
|000043f0| f5 02 ce ff 20 22 00 00 | 54 68 65 20 4f 55 54 50 |.... "..|The OUTP|
|00004400| 55 54 3a 20 6b 65 79 77 | 6f 72 64 20 77 69 6c 6c |UT: keyw|ord will|
|00004410| 20 61 6c 73 6f 20 61 6c | 6c 6f 77 20 61 6e 20 6f | also al|low an o|
|00004420| 75 74 70 75 74 20 70 61 | 72 61 6d 65 74 65 72 20 |utput pa|rameter |
|00004430| 74 6f 20 62 65 20 6d 61 | 70 70 65 64 20 74 6f 20 |to be ma|pped to |
|00004440| 61 20 6d 61 74 63 68 69 | 6e 67 20 70 69 65 63 65 |a matchi|ng piece|
|00004450| 20 6f 66 20 63 6f 64 65 | 20 00 00 00 00 7c 00 00 | of code| ....|..|
|00004460| a5 54 00 00 40 58 d3 01 | ee 9b cd ff ce ca cd ff |.T..@X..|........|
|00004470| 20 22 00 00 72 61 74 68 | 65 72 20 74 68 61 6e 20 | "..rath|er than |
|00004480| 74 6f 20 61 20 74 79 70 | 65 6d 61 70 2e 0d 07 00 |to a typ|emap....|
|00004490| 12 d1 a1 00 12 d1 a1 00 | 00 00 00 00 07 05 05 05 |........|........|
|000044a0| 0c d2 a1 00 12 d1 a1 00 | 0c d2 a1 00 00 00 00 00 |........|........|
|000044b0| 00 54 00 00 01 10 00 00 | 41 a0 8c 00 00 00 00 00 |.T......|A.......|
|000044c0| 00 10 00 00 02 1c 00 00 | 38 07 00 00 00 00 00 00 |........|8.......|
|000044d0| 12 d1 a1 00 0c d2 a1 00 | 00 00 00 00 00 1c 00 00 |........|........|
|000044e0| 25 2c 00 00 40 a0 8c 00 | 8c 4d cb ff 9c 74 cb ff |%,..@...|.M...t..|
|000044f0| 70 1a 00 00 16 00 00 00 | b0 fc 07 00 00 00 00 00 |p.......|........|
|00004500| 62 6f 6f 6c 5f 74 0d 00 | 00 2c 00 00 25 34 00 00 |bool_t..|.,..%4..|
|00004510| 40 80 32 02 ac 1e cb ff | bc 45 cb ff 70 1a 00 00 |@.2.....|.E..p...|
|00004520| 72 70 63 62 5f 67 65 74 | 74 69 6d 65 28 68 6f 73 |rpcb_get|time(hos|
|00004530| 74 2c 74 69 6d 65 70 29 | 0d 00 00 00 00 34 00 00 |t,timep)|.....4..|
|00004540| 25 28 00 00 40 90 5f 01 | cc ef ca ff dc 16 cb ff |%(..@._.|........|
|00004550| 70 1a 00 00 20 20 20 20 | 20 63 68 61 72 20 2a 68 |p... | char *h|
|00004560| 6f 73 74 0d 00 28 00 00 | 25 2c 00 00 40 e0 a5 01 |ost..(..|%,..@...|
|00004570| ec c0 ca ff fc e7 ca ff | 70 1a 00 00 20 20 20 20 |........|p... |
|00004580| 20 74 69 6d 65 5f 74 20 | 26 74 69 6d 65 70 0d 00 | time_t |&timep..|
|00004590| 00 2c 00 00 25 28 00 00 | 40 40 19 01 0c 92 ca ff |.,..%(..|@@......|
|000045a0| 1c b9 ca ff 70 1a 00 00 | 20 20 20 20 20 4f 55 54 |....p...| OUT|
|000045b0| 50 55 54 3a 0d 00 00 00 | 00 28 00 00 a5 6c 00 00 |PUT:....|.(...l..|
|000045c0| 40 60 d8 03 2c 63 ca ff | 3c 8a ca ff 70 1a 00 00 |@`..,c..|<...p...|
|000045d0| 20 20 20 20 20 74 69 6d | 65 70 20 73 76 5f 73 65 | tim|ep sv_se|
|000045e0| 74 6e 76 28 53 54 28 31 | 29 2c 20 28 64 6f 75 62 |tnv(ST(1|), (doub|
|000045f0| 6c 65 29 74 69 6d 65 70 | 29 3b 0d 08 0c d3 a1 00 |le)timep|);......|
|00004600| 12 d1 a1 00 00 00 00 00 | 08 68 65 20 12 00 00 00 |........|.he ....|
|00004610| 00 00 00 00 07 63 62 5f | 18 d4 a1 00 18 d4 a1 00 |.....cb_|........|
|00004620| 00 00 00 00 00 6c 00 00 | a5 34 00 00 40 00 00 00 |.....l..|.4..@...|
|00004630| 9c 4e ca ff 5c 5b ca ff | 00 00 00 00 0d 08 61 6c |.N..\[..|......al|
|00004640| 18 d5 a1 00 00 00 00 00 | 07 72 65 20 0a d6 a1 00 |........|.re ....|
|00004650| 0a d6 a1 00 00 00 00 00 | 00 34 00 00 a5 34 00 00 |........|.4...4..|
|00004660| 40 90 fe 01 fc ed c9 ff | ac 24 ca ff 18 2b 00 00 |@.......|.$...+..|
|00004670| 54 68 65 20 43 4f 44 45 | 3a 20 4b 65 79 77 6f 72 |The CODE|: Keywor|
|00004680| 64 0d 08 65 0a d7 a1 00 | 00 00 00 00 00 34 00 00 |d..e....|.....4..|
|00004690| 05 80 00 00 00 b0 c9 07 | c7 98 c9 ff a7 c7 c9 ff |........|........|
|000046a0| 20 22 00 00 54 68 69 73 | 20 6b 65 79 77 6f 72 64 | "..This| keyword|
|000046b0| 20 69 73 20 75 73 65 64 | 20 69 6e 20 6d 6f 72 65 | is used| in more|
|000046c0| 20 63 6f 6d 70 6c 69 63 | 61 74 65 64 20 58 53 55 | complic|ated XSU|
|000046d0| 42 73 20 77 68 69 63 68 | 20 72 65 71 75 69 72 65 |Bs which| require|
|000046e0| 20 73 70 65 63 69 61 6c | 20 68 61 6e 64 6c 69 6e | special| handlin|
|000046f0| 67 20 66 6f 72 20 74 68 | 65 20 43 20 66 75 6e 63 |g for th|e C func|
|00004700| 74 69 6f 6e 2e 20 20 54 | 68 65 20 00 00 80 00 00 |tion. T|he .....|
|00004710| 25 80 00 00 40 4c c4 07 | a0 60 c9 ff 80 8f c9 ff |%...@L..|.`......|
|00004720| 20 22 00 00 52 45 54 56 | 41 4c 20 76 61 72 69 61 | "..RETV|AL varia|
|00004730| 62 6c 65 20 69 73 20 61 | 76 61 69 6c 61 62 6c 65 |ble is a|vailable|
|00004740| 20 62 75 74 20 77 69 6c | 6c 20 6e 6f 74 20 62 65 | but wil|l not be|
|00004750| 20 72 65 74 75 72 6e 65 | 64 20 75 6e 6c 65 73 73 | returne|d unless|
|00004760| 20 69 74 20 69 73 20 73 | 70 65 63 69 66 69 65 64 | it is s|pecified|
|00004770| 20 75 6e 64 65 72 20 74 | 68 65 20 4f 55 54 50 55 | under t|he OUTPU|
|00004780| 54 3a 20 6b 65 79 77 6f | 72 64 2e 0d 00 80 00 00 |T: keywo|rd......|
|00004790| 05 84 00 00 00 28 d0 07 | c9 f1 c8 ff a9 20 c9 ff |.....(..|..... ..|
|000047a0| 20 22 00 00 54 68 65 20 | 66 6f 6c 6c 6f 77 69 6e | "..The |followin|
|000047b0| 67 20 58 53 55 42 20 69 | 73 20 66 6f 72 20 61 20 |g XSUB i|s for a |
|000047c0| 43 20 66 75 6e 63 74 69 | 6f 6e 20 77 68 69 63 68 |C functi|on which|
|000047d0| 20 72 65 71 75 69 72 65 | 73 20 73 70 65 63 69 61 | require|s specia|
|000047e0| 6c 20 68 61 6e 64 6c 69 | 6e 67 20 6f 66 20 69 74 |l handli|ng of it|
|000047f0| 73 20 70 61 72 61 6d 65 | 74 65 72 73 2e 20 20 54 |s parame|ters. T|
|00004800| 68 65 20 50 65 72 6c 20 | 75 73 61 67 65 20 00 00 |he Perl |usage ..|
|00004810| 00 84 00 00 a5 4c 00 00 | 40 18 f6 00 a2 b9 c8 ff |.....L..|@.......|
|00004820| 82 e8 c8 ff 20 22 00 00 | 69 73 20 67 69 76 65 6e |.... "..|is given|
|00004830| 20 66 69 72 73 74 2e 0d | 07 05 05 05 12 d8 a1 00 | first..|........|
|00004840| 12 d8 a1 00 00 00 00 00 | 07 08 05 05 0c d9 a1 00 |........|........|
|00004850| 12 d8 a1 00 0c d9 a1 00 | 00 00 00 00 00 4c 00 00 |........|.....L..|
|00004860| a5 70 00 00 40 20 36 04 | 9b 52 c8 ff ab 79 c8 ff |.p..@ 6.|.R...y..|
|00004870| 70 1a 00 00 24 73 74 61 | 74 75 73 20 3d 20 72 70 |p...$sta|tus = rp|
|00004880| 63 62 5f 67 65 74 74 69 | 6d 65 28 20 22 6c 6f 63 |cb_getti|me( "loc|
|00004890| 61 6c 68 6f 73 74 22 2c | 20 24 74 69 6d 65 70 20 |alhost",| $timep |
|000048a0| 29 3b 0d 08 0c da a1 00 | 12 d8 a1 00 00 00 00 00 |);......|........|
|000048b0| 08 20 70 61 12 00 00 00 | 00 00 00 00 07 20 74 79 |. pa....|..... ty|
|000048c0| 18 db a1 00 18 db a1 00 | 00 00 00 00 00 70 00 00 |........|.....p..|
|000048d0| a5 24 00 00 40 00 00 00 | 0b 3e c8 ff cb 4a c8 ff |.$..@...|.>...J..|
|000048e0| 00 00 00 00 0d 08 a1 00 | 18 dc a1 00 00 00 00 00 |........|........|
|000048f0| 00 24 00 00 a5 4c 00 00 | 40 b0 75 01 3b e5 c7 ff |.$...L..|@.u.;...|
|00004900| 1b 14 c8 ff 20 22 00 00 | 54 68 65 20 58 53 55 42 |.... "..|The XSUB|
|00004910| 20 66 6f 6c 6c 6f 77 73 | 2e 0d 07 61 12 dd a1 00 | follows|...a....|
|00004920| 12 dd a1 00 00 00 00 00 | 07 20 64 65 0c de a1 00 |........|. de....|
|00004930| 12 dd a1 00 0c de a1 00 | 00 00 00 00 00 4c 00 00 |........|.....L..|
|00004940| 25 20 00 00 40 a0 8c 00 | 34 7e c7 ff 44 a5 c7 ff |% ..@...|4~..D...|
|00004950| 70 1a 00 00 62 6f 6f 6c | 5f 74 0d 00 00 20 00 00 |p...bool|_t... ..|
|00004960| 25 34 00 00 40 80 32 02 | 54 4f c7 ff 64 76 c7 ff |%4..@.2.|TO..dv..|
|00004970| 70 1a 00 00 72 70 63 62 | 5f 67 65 74 74 69 6d 65 |p...rpcb|_gettime|
|00004980| 28 68 6f 73 74 2c 74 69 | 6d 65 70 29 0d 00 00 00 |(host,ti|mep)....|
|00004990| 00 34 00 00 25 28 00 00 | 40 90 5f 01 74 20 c7 ff |.4..%(..|@._.t ..|
|000049a0| 84 47 c7 ff 70 1a 00 00 | 20 20 20 20 20 63 68 61 |.G..p...| cha|
|000049b0| 72 20 2a 68 6f 73 74 0d | 00 28 00 00 25 2c 00 00 |r *host.|.(..%,..|
|000049c0| 40 70 8e 01 94 f1 c6 ff | a4 18 c7 ff 70 1a 00 00 |@p......|....p...|
|000049d0| 20 20 20 20 20 74 69 6d | 65 5f 74 20 74 69 6d 65 | tim|e_t time|
|000049e0| 70 0d 00 00 00 2c 00 00 | 25 24 00 00 40 60 ea 00 |p....,..|%$..@`..|
|000049f0| b4 c2 c6 ff c4 e9 c6 ff | 70 1a 00 00 20 20 20 20 |........|p... |
|00004a00| 20 43 4f 44 45 3a 0d 00 | 00 24 00 00 25 4c 00 00 | CODE:..|.$..%L..|
|00004a10| 40 00 65 04 d4 93 c6 ff | e4 ba c6 ff 70 1a 00 00 |@.e.....|....p...|
|00004a20| 20 20 20 20 20 20 20 20 | 20 20 52 45 54 56 41 4c | | RETVAL|
|00004a30| 20 3d 20 72 70 63 62 5f | 67 65 74 74 69 6d 65 28 | = rpcb_|gettime(|
|00004a40| 20 68 6f 73 74 2c 20 26 | 74 69 6d 65 70 20 29 3b | host, &|timep );|
|00004a50| 0d 00 00 00 00 4c 00 00 | 25 28 00 00 40 40 19 01 |.....L..|%(..@@..|
|00004a60| f4 64 c6 ff 04 8c c6 ff | 70 1a 00 00 20 20 20 20 |.d......|p... |
|00004a70| 20 4f 55 54 50 55 54 3a | 0d 00 00 00 00 28 00 00 | OUTPUT:|.....(..|
|00004a80| 25 24 00 00 40 60 ea 00 | 14 36 c6 ff 24 5d c6 ff |%$..@`..|.6..$]..|
|00004a90| 70 1a 00 00 20 20 20 20 | 20 74 69 6d 65 70 0d 00 |p... | timep..|
|00004aa0| 00 24 00 00 a5 50 00 00 | 40 d0 01 01 34 07 c6 ff |.$...P..|@...4...|
|00004ab0| 44 2e c6 ff 70 1a 00 00 | 20 20 20 20 20 52 45 54 |D...p...| RET|
|00004ac0| 56 41 4c 0d 08 20 20 20 | 0c df a1 00 12 dd a1 00 |VAL.. |........|
|00004ad0| 00 00 00 00 08 20 64 6f | 12 00 00 00 00 00 00 00 |..... do|........|
|00004ae0| 07 20 20 20 18 e0 a1 00 | 18 e0 a1 00 00 00 00 00 |. ....|........|
|00004af0| 00 50 00 00 a5 34 00 00 | 40 00 00 00 a4 f2 c5 ff |.P...4..|@.......|
|00004b00| 64 ff c5 ff 00 00 00 00 | 0d 08 20 20 18 e1 a1 00 |d.......|.. ....|
|00004b10| 00 00 00 00 07 20 20 20 | 0a e2 a1 00 0a e2 a1 00 |..... |........|
|00004b20| 00 00 00 00 00 34 00 00 | a5 34 00 00 40 ce c1 01 |.....4..|.4..@...|
|00004b30| 04 92 c5 ff b4 c8 c5 ff | 18 2b 00 00 54 68 65 20 |........|.+..The |
|00004b40| 49 4e 49 54 3a 20 4b 65 | 79 77 6f 72 64 0d 08 00 |INIT: Ke|yword...|
|00004b50| 0a e3 a1 00 00 00 00 00 | 00 34 00 00 05 84 00 00 |........|.4......|
|00004b60| 00 28 e2 07 cf 3c c5 ff | af 6b c5 ff 20 22 00 00 |.(...<..|.k.. "..|
|00004b70| 54 68 65 20 49 4e 49 54 | 3a 20 6b 65 79 77 6f 72 |The INIT|: keywor|
|00004b80| 64 20 61 6c 6c 6f 77 73 | 20 69 6e 69 74 69 61 6c |d allows| initial|
|00004b90| 69 7a 61 74 69 6f 6e 20 | 74 6f 20 62 65 20 69 6e |ization |to be in|
|00004ba0| 73 65 72 74 65 64 20 69 | 6e 74 6f 20 74 68 65 20 |serted i|nto the |
|00004bb0| 58 53 55 42 20 62 65 66 | 6f 72 65 20 74 68 65 20 |XSUB bef|ore the |
|00004bc0| 63 6f 6d 70 69 6c 65 72 | 20 67 65 6e 65 72 61 74 |compiler| generat|
|00004bd0| 65 73 20 74 68 65 20 63 | 61 6c 6c 20 00 84 00 00 |es the c|all ....|
|00004be0| 05 80 00 00 00 cc a7 07 | a8 04 c5 ff 88 33 c5 ff |........|.....3..|
|00004bf0| 20 22 00 00 74 6f 20 74 | 68 65 20 43 20 66 75 6e | "..to t|he C fun|
|00004c00| 63 74 69 6f 6e 2e 20 20 | 55 6e 6c 69 6b 65 20 74 |ction. |Unlike t|
|00004c10| 68 65 20 43 4f 44 45 3a | 20 6b 65 79 77 6f 72 64 |he CODE:| keyword|
|00004c20| 20 61 62 6f 76 65 2c 20 | 74 68 69 73 20 6b 65 79 | above, |this key|
|00004c30| 77 6f 72 64 20 64 6f 65 | 73 20 6e 6f 74 20 61 66 |word doe|s not af|
|00004c40| 66 65 63 74 20 74 68 65 | 20 77 61 79 20 74 68 65 |fect the| way the|
|00004c50| 20 63 6f 6d 70 69 6c 65 | 72 20 00 00 00 80 00 00 | compile|r ......|
|00004c60| a5 4c 00 00 40 78 59 01 | 81 cc c4 ff 61 fb c4 ff |.L..@xY.|....a...|
|00004c70| 20 22 00 00 68 61 6e 64 | 6c 65 73 20 52 45 54 56 | "..hand|les RETV|
|00004c80| 41 4c 2e 0d 07 58 af 00 | 12 e4 a1 00 12 e4 a1 00 |AL...X..|........|
|00004c90| 00 00 00 00 07 1a 00 f0 | 0c e5 a1 00 12 e4 a1 00 |........|........|
|00004ca0| 0c e5 a1 00 00 00 00 00 | 00 4c 00 00 25 20 00 00 |........|.L..% ..|
|00004cb0| 40 a0 8c 00 7a 65 c4 ff | 8a 8c c4 ff 70 1a 00 00 |@...ze..|....p...|
|00004cc0| 62 6f 6f 6c 5f 74 0d 00 | 00 20 00 00 25 34 00 00 |bool_t..|. ..%4..|
|00004cd0| 40 80 32 02 9a 36 c4 ff | aa 5d c4 ff 70 1a 00 00 |@.2..6..|.]..p...|
|00004ce0| 72 70 63 62 5f 67 65 74 | 74 69 6d 65 28 68 6f 73 |rpcb_get|time(hos|
|00004cf0| 74 2c 74 69 6d 65 70 29 | 0d 00 00 00 00 34 00 00 |t,timep)|.....4..|
|00004d00| 25 2c 00 00 40 00 77 01 | ba 07 c4 ff ca 2e c4 ff |%,..@.w.|........|
|00004d10| 70 1a 00 00 20 20 20 20 | 20 20 63 68 61 72 20 2a |p... | char *|
|00004d20| 68 6f 73 74 0d 00 00 00 | 00 2c 00 00 25 2c 00 00 |host....|.,..%,..|
|00004d30| 40 50 bd 01 da d8 c3 ff | ea ff c3 ff 70 1a 00 00 |@P......|....p...|
|00004d40| 20 20 20 20 20 20 74 69 | 6d 65 5f 74 20 26 74 69 | ti|me_t &ti|
|00004d50| 6d 65 70 0d 00 2c 00 00 | 25 24 00 00 40 d0 01 01 |mep..,..|%$..@...|
|00004d60| fa a9 c3 ff 0a d1 c3 ff | 70 1a 00 00 20 20 20 20 |........|p... |
|00004d70| 20 20 49 4e 49 54 3a 0d | 00 24 00 00 25 40 00 00 | INIT:.|.$..%@..|
|00004d80| 40 a0 7a 03 1a 7b c3 ff | 2a a2 c3 ff 70 1a 00 00 |@.z..{..|*...p...|
|00004d90| 20 20 20 20 20 20 70 72 | 69 6e 74 66 28 22 23 20 | pr|intf("# |
|00004da0| 48 6f 73 74 20 69 73 20 | 25 73 5c 6e 22 2c 20 68 |Host is |%s\n", h|
|00004db0| 6f 73 74 20 29 3b 0d 00 | 00 40 00 00 25 28 00 00 |ost );..|.@..%(..|
|00004dc0| 40 b0 30 01 3a 4c c3 ff | 4a 73 c3 ff 70 1a 00 00 |@.0.:L..|Js..p...|
|00004dd0| 20 20 20 20 20 20 4f 55 | 54 50 55 54 3a 0d 00 00 | OU|TPUT:...|
|00004de0| 00 28 00 00 a5 50 00 00 | 40 d0 01 01 5a 1d c3 ff |.(...P..|@...Z...|
|00004df0| 6a 44 c3 ff 70 1a 00 00 | 20 20 20 20 20 20 74 69 |jD..p...| ti|
|00004e00| 6d 65 70 0d 08 20 6f 6e | 0c e6 a1 00 12 e4 a1 00 |mep.. on|........|
|00004e10| 00 00 00 00 08 49 6e 20 | 12 00 00 00 00 00 00 00 |.....In |........|
|00004e20| 07 6d 65 6e 18 e7 a1 00 | 18 e7 a1 00 00 00 00 00 |.men....|........|
|00004e30| 00 50 00 00 a5 34 00 00 | 40 00 00 00 ca 08 c3 ff |.P...4..|@.......|
|00004e40| 8a 15 c3 ff 00 00 00 00 | 0d 08 63 68 18 e8 a1 00 |........|..ch....|
|00004e50| 00 00 00 00 07 74 6f 20 | 0a e9 a1 00 0a e9 a1 00 |.....to |........|
|00004e60| 00 00 00 00 00 34 00 00 | a5 38 00 00 40 20 28 02 |.....4..|.8..@ (.|
|00004e70| 2a a8 c2 ff da de c2 ff | 18 2b 00 00 54 68 65 20 |*.......|.+..The |
|00004e80| 4e 4f 5f 49 4e 49 54 20 | 4b 65 79 77 6f 72 64 0d |NO_INIT |Keyword.|
|00004e90| 08 20 74 68 0a ea a1 00 | 00 00 00 00 00 38 00 00 |. th....|.....8..|
|00004ea0| 05 84 00 00 00 b4 c5 07 | f5 52 c2 ff d5 81 c2 ff |........|.R......|
|00004eb0| 20 22 00 00 54 68 65 20 | 4e 4f 5f 49 4e 49 54 20 | "..The |NO_INIT |
|00004ec0| 6b 65 79 77 6f 72 64 20 | 69 73 20 75 73 65 64 20 |keyword |is used |
|00004ed0| 74 6f 20 69 6e 64 69 63 | 61 74 65 20 74 68 61 74 |to indic|ate that|
|00004ee0| 20 61 20 66 75 6e 63 74 | 69 6f 6e 20 70 61 72 61 | a funct|ion para|
|00004ef0| 6d 65 74 65 72 20 69 73 | 20 62 65 69 6e 67 20 75 |meter is| being u|
|00004f00| 73 65 64 20 6f 6e 6c 79 | 20 61 73 20 61 6e 20 6f |sed only| as an o|
|00004f10| 75 74 70 75 74 20 76 61 | 6c 75 65 2e 20 20 00 00 |utput va|lue. ..|
|00004f20| 00 84 00 00 85 9c 00 00 | 00 d0 a0 07 ce 1a c2 ff |........|........|
|00004f30| ae 49 c2 ff 20 22 00 00 | 54 68 65 20 07 70 61 72 |.I.. "..|The .par|
|00004f40| 10 eb a1 00 10 eb a1 00 | 00 00 00 00 78 73 75 62 |........|....xsub|
|00004f50| 70 70 08 73 10 00 00 00 | 00 00 00 00 20 63 6f 6d |pp.s....|.... com|
|00004f60| 70 69 6c 65 72 20 77 69 | 6c 6c 20 6e 6f 72 6d 61 |piler wi|ll norma|
|00004f70| 6c 6c 79 20 67 65 6e 65 | 72 61 74 65 20 63 6f 64 |lly gene|rate cod|
|00004f80| 65 20 74 6f 20 72 65 61 | 64 20 74 68 65 20 76 61 |e to rea|d the va|
|00004f90| 6c 75 65 73 20 6f 66 20 | 61 6c 6c 20 66 75 6e 63 |lues of |all func|
|00004fa0| 74 69 6f 6e 20 70 61 72 | 61 6d 65 74 65 72 73 20 |tion par|ameters |
|00004fb0| 66 72 6f 6d 20 74 68 65 | 20 00 00 00 00 9c 00 00 |from the| .......|
|00004fc0| 05 84 00 00 00 94 c7 07 | a7 e2 c1 ff 87 11 c2 ff |........|........|
|00004fd0| 20 22 00 00 61 72 67 75 | 6d 65 6e 74 20 73 74 61 | "..argu|ment sta|
|00004fe0| 63 6b 20 61 6e 64 20 61 | 73 73 69 67 6e 20 74 68 |ck and a|ssign th|
|00004ff0| 65 6d 20 74 6f 20 43 20 | 76 61 72 69 61 62 6c 65 |em to C |variable|
|00005000| 73 20 75 70 6f 6e 20 65 | 6e 74 72 79 20 74 6f 20 |s upon e|ntry to |
|00005010| 74 68 65 20 66 75 6e 63 | 74 69 6f 6e 2e 20 20 4e |the func|tion. N|
|00005020| 4f 5f 49 4e 49 54 20 77 | 69 6c 6c 20 74 65 6c 6c |O_INIT w|ill tell|
|00005030| 20 74 68 65 20 63 6f 6d | 70 69 6c 65 72 20 00 00 | the com|piler ..|
|00005040| 00 84 00 00 05 84 00 00 | 00 84 b9 07 80 aa c1 ff |........|........|
|00005050| 60 d9 c1 ff 20 22 00 00 | 74 68 61 74 20 73 6f 6d |`... "..|that som|
|00005060| 65 20 70 61 72 61 6d 65 | 74 65 72 73 20 77 69 6c |e parame|ters wil|
|00005070| 6c 20 62 65 20 75 73 65 | 64 20 66 6f 72 20 6f 75 |l be use|d for ou|
|00005080| 74 70 75 74 20 72 61 74 | 68 65 72 20 74 68 61 6e |tput rat|her than|
|00005090| 20 66 6f 72 20 69 6e 70 | 75 74 20 61 6e 64 20 74 | for inp|ut and t|
|000050a0| 68 61 74 20 74 68 65 79 | 20 77 69 6c 6c 20 62 65 |hat they| will be|
|000050b0| 20 68 61 6e 64 6c 65 64 | 20 62 65 66 6f 72 65 20 | handled| before |
|000050c0| 74 68 65 20 00 84 00 00 | 25 30 00 00 40 f4 76 01 |the ....|%0..@.v.|
|000050d0| 59 72 c1 ff 39 a1 c1 ff | 20 22 00 00 66 75 6e 63 |Yr..9...| "..func|
|000050e0| 74 69 6f 6e 20 74 65 72 | 6d 69 6e 61 74 65 73 2e |tion ter|minates.|
|000050f0| 0d 00 00 00 00 30 00 00 | 05 80 00 00 00 14 75 07 |.....0..|......u.|
|00005100| 82 03 c1 ff 62 32 c1 ff | 20 22 00 00 54 68 65 20 |....b2..| "..The |
|00005110| 66 6f 6c 6c 6f 77 69 6e | 67 20 65 78 61 6d 70 6c |followin|g exampl|
|00005120| 65 20 73 68 6f 77 73 20 | 61 20 76 61 72 69 61 74 |e shows |a variat|
|00005130| 69 6f 6e 20 6f 66 20 74 | 68 65 20 72 70 63 62 5f |ion of t|he rpcb_|
|00005140| 67 65 74 74 69 6d 65 28 | 29 20 66 75 6e 63 74 69 |gettime(|) functi|
|00005150| 6f 6e 2e 20 54 68 69 73 | 20 66 75 6e 63 74 69 6f |on. This| functio|
|00005160| 6e 20 75 73 65 73 20 74 | 68 65 20 74 69 6d 65 70 |n uses t|he timep|
|00005170| 20 00 00 00 00 80 00 00 | a5 8c 00 00 40 24 b2 05 | .......|....@$..|
|00005180| 5b cb c0 ff 3b fa c0 ff | 20 22 00 00 76 61 72 69 |[...;...| "..vari|
|00005190| 61 62 6c 65 20 6f 6e 6c | 79 20 61 73 20 61 6e 20 |able onl|y as an |
|000051a0| 6f 75 74 70 75 74 20 76 | 61 72 69 61 62 6c 65 20 |output v|ariable |
|000051b0| 61 6e 64 20 64 6f 65 73 | 20 6e 6f 74 20 63 61 72 |and does| not car|
|000051c0| 65 20 61 62 6f 75 74 20 | 69 74 73 20 69 6e 69 74 |e about |its init|
|000051d0| 69 61 6c 20 63 6f 6e 74 | 65 6e 74 73 2e 0d 07 68 |ial cont|ents...h|
|000051e0| 12 ec a1 00 12 ec a1 00 | 00 00 00 00 07 6e 20 76 |........|.....n v|
|000051f0| 0c ed a1 00 12 ec a1 00 | 0c ed a1 00 00 00 00 00 |........|........|
|00005200| 00 8c 00 00 01 10 00 00 | 41 a0 8c 00 00 00 00 00 |........|A.......|
|00005210| 00 10 00 00 02 1c 00 00 | d4 08 00 00 00 00 00 00 |........|........|
|00005220| 12 ec a1 00 0c ed a1 00 | 00 00 00 00 00 1c 00 00 |........|........|
|00005230| 25 2c 00 00 40 a0 8c 00 | db 4d be ff eb 74 be ff |%,..@...|.M...t..|
|00005240| 70 1a 00 00 16 00 00 00 | b0 fc 07 00 00 00 00 00 |p.......|........|
|00005250| 62 6f 6f 6c 5f 74 0d 00 | 00 2c 00 00 25 34 00 00 |bool_t..|.,..%4..|
|00005260| 40 80 32 02 fb 1e be ff | 0b 46 be ff 70 1a 00 00 |@.2.....|.F..p...|
|00005270| 72 70 63 62 5f 67 65 74 | 74 69 6d 65 28 68 6f 73 |rpcb_get|time(hos|
|00005280| 74 2c 74 69 6d 65 70 29 | 0d 00 00 00 00 34 00 00 |t,timep)|.....4..|
|00005290| 25 28 00 00 40 90 5f 01 | 1b f0 bd ff 2b 17 be ff |%(..@._.|....+...|
|000052a0| 70 1a 00 00 20 20 20 20 | 20 63 68 61 72 20 2a 68 |p... | char *h|
|000052b0| 6f 73 74 0d 00 28 00 00 | 25 38 00 00 40 40 90 02 |ost..(..|%8..@@..|
|000052c0| 3b c1 bd ff 4b e8 bd ff | 70 1a 00 00 20 20 20 20 |;...K...|p... |
|000052d0| 20 74 69 6d 65 5f 74 20 | 26 74 69 6d 65 70 20 3d | time_t |&timep =|
|000052e0| 20 4e 4f 5f 49 4e 49 54 | 0d 00 00 00 00 38 00 00 | NO_INIT|.....8..|
|000052f0| 25 28 00 00 40 40 19 01 | 5b 92 bd ff 6b b9 bd ff |%(..@@..|[...k...|
|00005300| 70 1a 00 00 20 20 20 20 | 20 4f 55 54 50 55 54 3a |p... | OUTPUT:|
|00005310| 0d 00 00 00 00 28 00 00 | a5 4c 00 00 40 60 ea 00 |.....(..|.L..@`..|
|00005320| 7b 63 bd ff 8b 8a bd ff | 70 1a 00 00 20 20 20 20 |{c......|p... |
|00005330| 20 74 69 6d 65 70 0d 08 | 0c ee a1 00 12 ec a1 00 | timep..|........|
|00005340| 00 00 00 00 08 68 65 20 | 12 00 00 00 00 00 00 00 |.....he |........|
|00005350| 07 69 72 65 18 ef a1 00 | 18 ef a1 00 00 00 00 00 |.ire....|........|
|00005360| 00 4c 00 00 a5 34 00 00 | 40 00 00 00 eb 4e bd ff |.L...4..|@....N..|
|00005370| ab 5b bd ff 00 00 00 00 | 0d 08 64 2c 18 f0 a1 00 |.[......|..d,....|
|00005380| 00 00 00 00 07 73 65 64 | 0a f1 a1 00 0a f1 a1 00 |.....sed|........|
|00005390| 00 00 00 00 00 34 00 00 | a5 44 00 00 40 d6 fa 02 |.....4..|.D..@...|
|000053a0| 4b ee bc ff fb 24 bd ff | 18 2b 00 00 49 6e 69 74 |K....$..|.+..Init|
|000053b0| 69 61 6c 69 7a 69 6e 67 | 20 46 75 6e 63 74 69 6f |ializing| Functio|
|000053c0| 6e 20 50 61 72 61 6d 65 | 74 65 72 73 0d 08 a1 00 |n Parame|ters....|
|000053d0| 0a f2 a1 00 00 00 00 00 | 00 44 00 00 05 80 00 00 |........|.D......|
|000053e0| 00 cc 83 07 16 99 bc ff | f6 c7 bc ff 20 22 00 00 |........|.... "..|
|000053f0| 46 75 6e 63 74 69 6f 6e | 20 70 61 72 61 6d 65 74 |Function| paramet|
|00005400| 65 72 73 20 61 72 65 20 | 6e 6f 72 6d 61 6c 6c 79 |ers are |normally|
|00005410| 20 69 6e 69 74 69 61 6c | 69 7a 65 64 20 77 69 74 | initial|ized wit|
|00005420| 68 20 74 68 65 69 72 20 | 76 61 6c 75 65 73 20 66 |h their |values f|
|00005430| 72 6f 6d 20 74 68 65 20 | 61 72 67 75 6d 65 6e 74 |rom the |argument|
|00005440| 20 73 74 61 63 6b 2e 20 | 20 54 68 65 20 74 79 70 | stack. | The typ|
|00005450| 65 6d 61 70 73 20 00 00 | 00 80 00 00 05 84 00 00 |emaps ..|........|
|00005460| 00 10 df 07 ef 60 bc ff | cf 8f bc ff 20 22 00 00 |.....`..|.... "..|
|00005470| 63 6f 6e 74 61 69 6e 20 | 74 68 65 20 63 6f 64 65 |contain |the code|
|00005480| 20 73 65 67 6d 65 6e 74 | 73 20 77 68 69 63 68 20 | segment|s which |
|00005490| 61 72 65 20 75 73 65 64 | 20 74 6f 20 74 72 61 6e |are used| to tran|
|000054a0| 73 66 65 72 20 74 68 65 | 20 50 65 72 6c 20 76 61 |sfer the| Perl va|
|000054b0| 6c 75 65 73 20 74 6f 20 | 74 68 65 20 43 20 70 61 |lues to |the C pa|
|000054c0| 72 61 6d 65 74 65 72 73 | 2e 20 20 54 68 65 20 70 |rameters|. The p|
|000054d0| 72 6f 67 72 61 6d 6d 65 | 72 2c 20 00 00 84 00 00 |rogramme|r, .....|
|000054e0| 25 70 00 00 40 bc 40 06 | c8 28 bc ff a8 57 bc ff |%p..@.@.|.(...W..|
|000054f0| 20 22 00 00 68 6f 77 65 | 76 65 72 2c 20 69 73 20 | "..howe|ver, is |
|00005500| 61 6c 6c 6f 77 65 64 20 | 74 6f 20 6f 76 65 72 72 |allowed |to overr|
|00005510| 69 64 65 20 74 68 65 20 | 74 79 70 65 6d 61 70 73 |ide the |typemaps|
|00005520| 20 61 6e 64 20 73 75 70 | 70 6c 79 20 61 6c 74 65 | and sup|ply alte|
|00005530| 72 6e 61 74 65 20 69 6e | 69 74 69 61 6c 69 7a 61 |rnate in|itializa|
|00005540| 74 69 6f 6e 20 63 6f 64 | 65 2e 0d 00 00 70 00 00 |tion cod|e....p..|
|00005550| 05 78 00 00 00 64 13 07 | f1 b9 bb ff d1 e8 bb ff |.x...d..|........|
|00005560| 20 22 00 00 54 68 65 20 | 66 6f 6c 6c 6f 77 69 6e | "..The |followin|
|00005570| 67 20 63 6f 64 65 20 64 | 65 6d 6f 6e 73 74 72 61 |g code d|emonstra|
|00005580| 74 65 73 20 68 6f 77 20 | 74 6f 20 73 75 70 70 6c |tes how |to suppl|
|00005590| 79 20 69 6e 69 74 69 61 | 6c 69 7a 61 74 69 6f 6e |y initia|lization|
|000055a0| 20 63 6f 64 65 20 66 6f | 72 20 66 75 6e 63 74 69 | code fo|r functi|
|000055b0| 6f 6e 20 70 61 72 61 6d | 65 74 65 72 73 2e 20 20 |on param|eters. |
|000055c0| 54 68 65 20 00 78 00 00 | 05 84 00 00 00 94 94 07 |The .x..|........|
|000055d0| ca 81 bb ff aa b0 bb ff | 20 22 00 00 69 6e 69 74 |........| "..init|
|000055e0| 69 61 6c 69 7a 61 74 69 | 6f 6e 20 63 6f 64 65 20 |ializati|on code |
|000055f0| 69 73 20 65 76 61 6c 27 | 64 20 62 79 20 74 68 65 |is eval'|d by the|
|00005600| 20 63 6f 6d 70 69 6c 65 | 72 20 62 65 66 6f 72 65 | compile|r before|
|00005610| 20 69 74 20 69 73 20 61 | 64 64 65 64 20 74 6f 20 | it is a|dded to |
|00005620| 74 68 65 20 6f 75 74 70 | 75 74 20 73 6f 20 61 6e |the outp|ut so an|
|00005630| 79 74 68 69 6e 67 20 77 | 68 69 63 68 20 73 68 6f |ything w|hich sho|
|00005640| 75 6c 64 20 62 65 20 00 | 00 84 00 00 a5 8c 00 00 |uld be .|........|
|00005650| 40 a0 cf 05 a3 49 bb ff | 83 78 bb ff 20 22 00 00 |@....I..|.x.. "..|
|00005660| 69 6e 74 65 72 70 72 65 | 74 65 64 20 6c 69 74 65 |interpre|ted lite|
|00005670| 72 61 6c 6c 79 2c 20 73 | 75 63 68 20 61 73 20 64 |rally, s|uch as d|
|00005680| 6f 75 62 6c 65 20 71 75 | 6f 74 65 73 2c 20 6d 75 |ouble qu|otes, mu|
|00005690| 73 74 20 62 65 20 70 72 | 6f 74 65 63 74 65 64 20 |st be pr|otected |
|000056a0| 77 69 74 68 20 62 61 63 | 6b 73 6c 61 73 68 65 73 |with bac|kslashes|
|000056b0| 2e 0d 07 65 12 f3 a1 00 | 12 f3 a1 00 00 00 00 00 |...e....|........|
|000056c0| 07 20 61 74 0c f4 a1 00 | 12 f3 a1 00 0c f4 a1 00 |. at....|........|
|000056d0| 00 00 00 00 00 8c 00 00 | 25 20 00 00 40 a0 8c 00 |........|% ..@...|
|000056e0| 9c e2 ba ff ac 09 bb ff | 70 1a 00 00 62 6f 6f 6c |........|p...bool|
|000056f0| 5f 74 0d 00 00 20 00 00 | 25 34 00 00 40 80 32 02 |_t... ..|%4..@.2.|
|00005700| bc b3 ba ff cc da ba ff | 70 1a 00 00 72 70 63 62 |........|p...rpcb|
|00005710| 5f 67 65 74 74 69 6d 65 | 28 68 6f 73 74 2c 74 69 |_gettime|(host,ti|
|00005720| 6d 65 70 29 0d 00 00 00 | 00 34 00 00 25 44 00 00 |mep)....|.4..%D..|
|00005730| 40 f0 c0 03 dc 84 ba ff | ec ab ba ff 70 1a 00 00 |@.......|....p...|
|00005740| 20 20 20 20 20 63 68 61 | 72 20 2a 68 6f 73 74 20 | cha|r *host |
|00005750| 3d 20 28 63 68 61 72 20 | 2a 29 53 76 50 56 28 53 |= (char |*)SvPV(S|
|00005760| 54 28 30 29 2c 6e 61 29 | 3b 0d 00 00 00 44 00 00 |T(0),na)|;....D..|
|00005770| 25 30 00 00 40 10 1b 02 | fc 55 ba ff 0c 7d ba ff |%0..@...|.U...}..|
|00005780| 70 1a 00 00 20 20 20 20 | 20 74 69 6d 65 5f 74 20 |p... | time_t |
|00005790| 26 74 69 6d 65 70 20 3d | 20 30 3b 0d 00 30 00 00 |&timep =| 0;..0..|
|000057a0| 25 28 00 00 40 40 19 01 | 1c 27 ba ff 2c 4e ba ff |%(..@@..|.'..,N..|
|000057b0| 70 1a 00 00 20 20 20 20 | 20 4f 55 54 50 55 54 3a |p... | OUTPUT:|
|000057c0| 0d 00 00 00 00 28 00 00 | a5 4c 00 00 40 60 ea 00 |.....(..|.L..@`..|
|000057d0| 3c f8 b9 ff 4c 1f ba ff | 70 1a 00 00 20 20 20 20 |<...L...|p... |
|000057e0| 20 74 69 6d 65 70 0d 08 | 0c f5 a1 00 12 f3 a1 00 | timep..|........|
|000057f0| 00 00 00 00 08 65 64 20 | 12 00 00 00 00 00 00 00 |.....ed |........|
|00005800| 07 64 20 69 18 f6 a1 00 | 18 f6 a1 00 00 00 00 00 |.d i....|........|
|00005810| 00 4c 00 00 a5 24 00 00 | 40 00 00 00 ac e3 b9 ff |.L...$..|@.......|
|00005820| 6c f0 b9 ff 00 00 00 00 | 0d 08 65 64 18 f7 a1 00 |l.......|..ed....|
|00005830| 00 00 00 00 00 24 00 00 | 05 80 00 00 00 ec 75 07 |.....$..|......u.|
|00005840| dc 8a b9 ff bc b9 b9 ff | 20 22 00 00 54 68 69 73 |........| "..This|
|00005850| 20 73 68 6f 75 6c 64 20 | 6e 6f 74 20 62 65 20 75 | should |not be u|
|00005860| 73 65 64 20 74 6f 20 73 | 75 70 70 6c 79 20 64 65 |sed to s|upply de|
|00005870| 66 61 75 6c 74 20 76 61 | 6c 75 65 73 20 66 6f 72 |fault va|lues for|
|00005880| 20 70 61 72 61 6d 65 74 | 65 72 73 2e 20 20 4f 6e | paramet|ers. On|
|00005890| 65 20 77 6f 75 6c 64 20 | 6e 6f 72 6d 61 6c 6c 79 |e would |normally|
|000058a0| 20 75 73 65 20 74 68 69 | 73 20 77 68 65 6e 20 61 | use thi|s when a|
|000058b0| 20 00 00 00 00 80 00 00 | 05 84 00 00 00 00 e3 07 | .......|........|
|000058c0| b5 52 b9 ff 95 81 b9 ff | 20 22 00 00 66 75 6e 63 |.R......| "..func|
|000058d0| 74 69 6f 6e 20 70 61 72 | 61 6d 65 74 65 72 20 6d |tion par|ameter m|
|000058e0| 75 73 74 20 62 65 20 70 | 72 6f 63 65 73 73 65 64 |ust be p|rocessed|
|000058f0| 20 62 79 20 61 6e 6f 74 | 68 65 72 20 6c 69 62 72 | by anot|her libr|
|00005900| 61 72 79 20 66 75 6e 63 | 74 69 6f 6e 20 62 65 66 |ary func|tion bef|
|00005910| 6f 72 65 20 69 74 20 63 | 61 6e 20 62 65 20 75 73 |ore it c|an be us|
|00005920| 65 64 2e 20 20 44 65 66 | 61 75 6c 74 20 70 61 72 |ed. Def|ault par|
|00005930| 61 6d 65 74 65 72 73 20 | 00 84 00 00 a5 48 00 00 |ameters |.....H..|
|00005940| 40 2c 47 02 8e 1a b9 ff | 6e 49 b9 ff 20 22 00 00 |@,G.....|nI.. "..|
|00005950| 61 72 65 20 63 6f 76 65 | 72 65 64 20 69 6e 20 74 |are cove|red in t|
|00005960| 68 65 20 6e 65 78 74 20 | 73 65 63 74 69 6f 6e 2e |he next |section.|
|00005970| 0d 07 77 69 0a f8 a1 00 | 0a f8 a1 00 00 00 00 00 |..wi....|........|
|00005980| 00 48 00 00 a5 3c 00 00 | 40 12 6e 02 e7 a3 b8 ff |.H...<..|@.n.....|
|00005990| 97 da b8 ff 18 2b 00 00 | 44 65 66 61 75 6c 74 20 |.....+..|Default |
|000059a0| 50 61 72 61 6d 65 74 65 | 72 20 56 61 6c 75 65 73 |Paramete|r Values|
|000059b0| 0d 08 20 69 0a f9 a1 00 | 00 00 00 00 00 3c 00 00 |.. i....|.....<..|
|000059c0| 05 84 00 00 00 14 f0 07 | b2 4e b8 ff 92 7d b8 ff |........|.N...}..|
|000059d0| 20 22 00 00 44 65 66 61 | 75 6c 74 20 76 61 6c 75 | "..Defa|ult valu|
|000059e0| 65 73 20 63 61 6e 20 62 | 65 20 73 70 65 63 69 66 |es can b|e specif|
|000059f0| 69 65 64 20 66 6f 72 20 | 66 75 6e 63 74 69 6f 6e |ied for |function|
|00005a00| 20 70 61 72 61 6d 65 74 | 65 72 73 20 62 79 20 70 | paramet|ers by p|
|00005a10| 6c 61 63 69 6e 67 20 61 | 6e 20 61 73 73 69 67 6e |lacing a|n assign|
|00005a20| 6d 65 6e 74 20 73 74 61 | 74 65 6d 65 6e 74 20 69 |ment sta|tement i|
|00005a30| 6e 20 74 68 65 20 70 61 | 72 61 6d 65 74 65 72 20 |n the pa|rameter |
|00005a40| 00 84 00 00 05 80 00 00 | 00 2c 7e 07 8b 16 b8 ff |........|.,~.....|
|00005a50| 6b 45 b8 ff 20 22 00 00 | 6c 69 73 74 2e 20 20 54 |kE.. "..|list. T|
|00005a60| 68 65 20 64 65 66 61 75 | 6c 74 20 76 61 6c 75 65 |he defau|lt value|
|00005a70| 20 6d 61 79 20 62 65 20 | 61 20 6e 75 6d 62 65 72 | may be |a number|
|00005a80| 20 6f 72 20 61 20 73 74 | 72 69 6e 67 2e 20 20 44 | or a st|ring. D|
|00005a90| 65 66 61 75 6c 74 73 20 | 73 68 6f 75 6c 64 20 61 |efaults |should a|
|00005aa0| 6c 77 61 79 73 20 62 65 | 20 75 73 65 64 20 6f 6e |lways be| used on|
|00005ab0| 20 74 68 65 20 72 69 67 | 68 74 2d 6d 6f 73 74 20 | the rig|ht-most |
|00005ac0| 00 80 00 00 25 2c 00 00 | 40 60 35 01 64 de b7 ff |....%,..|@`5.d...|
|00005ad0| 44 0d b8 ff 20 22 00 00 | 70 61 72 61 6d 65 74 65 |D... "..|paramete|
|00005ae0| 72 73 20 6f 6e 6c 79 2e | 0d 00 00 00 00 2c 00 00 |rs only.|.....,..|
|00005af0| 05 80 00 00 00 24 ad 07 | 8d 6f b7 ff 6d 9e b7 ff |.....$..|.o..m...|
|00005b00| 20 22 00 00 54 6f 20 61 | 6c 6c 6f 77 20 74 68 65 | "..To a|llow the|
|00005b10| 20 58 53 55 42 20 66 6f | 72 20 72 70 63 62 5f 67 | XSUB fo|r rpcb_g|
|00005b20| 65 74 74 69 6d 65 28 29 | 20 74 6f 20 68 61 76 65 |ettime()| to have|
|00005b30| 20 61 20 64 65 66 61 75 | 6c 74 20 68 6f 73 74 20 | a defau|lt host |
|00005b40| 76 61 6c 75 65 20 74 68 | 65 20 70 61 72 61 6d 65 |value th|e parame|
|00005b50| 74 65 72 73 20 74 6f 20 | 74 68 65 20 58 53 55 42 |ters to |the XSUB|
|00005b60| 20 63 6f 75 6c 64 20 62 | 65 20 00 00 00 80 00 00 | could b|e ......|
|00005b70| 05 84 00 00 00 84 9e 07 | 66 37 b7 ff 46 66 b7 ff |........|f7..Ff..|
|00005b80| 20 22 00 00 72 65 61 72 | 72 61 6e 67 65 64 2e 20 | "..rear|ranged. |
|00005b90| 20 54 68 65 20 58 53 55 | 42 20 77 69 6c 6c 20 74 | The XSU|B will t|
|00005ba0| 68 65 6e 20 63 61 6c 6c | 20 74 68 65 20 72 65 61 |hen call| the rea|
|00005bb0| 6c 20 72 70 63 62 5f 67 | 65 74 74 69 6d 65 28 29 |l rpcb_g|ettime()|
|00005bc0| 20 66 75 6e 63 74 69 6f | 6e 20 77 69 74 68 20 74 | functio|n with t|
|00005bd0| 68 65 20 70 61 72 61 6d | 65 74 65 72 73 20 69 6e |he param|eters in|
|00005be0| 20 74 68 65 20 63 6f 72 | 72 65 63 74 20 00 00 00 | the cor|rect ...|
|00005bf0| 00 84 00 00 a5 84 00 00 | 40 e4 37 05 3f ff b6 ff |........|@.7.?...|
|00005c00| 1f 2e b7 ff 20 22 00 00 | 6f 72 64 65 72 2e 20 20 |.... "..|order. |
|00005c10| 50 65 72 6c 20 77 69 6c | 6c 20 63 61 6c 6c 20 74 |Perl wil|l call t|
|00005c20| 68 69 73 20 58 53 55 42 | 20 77 69 74 68 20 65 69 |his XSUB| with ei|
|00005c30| 74 68 65 72 20 6f 66 20 | 74 68 65 20 66 6f 6c 6c |ther of |the foll|
|00005c40| 6f 77 69 6e 67 20 73 74 | 61 74 65 6d 65 6e 74 73 |owing st|atements|
|00005c50| 2e 0d 07 42 12 fa a1 00 | 12 fa a1 00 00 00 00 00 |...B....|........|
|00005c60| 07 00 00 00 0c fb a1 00 | 12 fa a1 00 0c fb a1 00 |........|........|
|00005c70| 00 00 00 00 00 84 00 00 | a5 6c 00 00 40 80 a9 03 |........|.l..@...|
|00005c80| 38 98 b6 ff 48 bf b6 ff | 70 1a 00 00 24 73 74 61 |8...H...|p...$sta|
|00005c90| 74 75 73 20 3d 20 72 70 | 63 62 5f 67 65 74 74 69 |tus = rp|cb_getti|
|00005ca0| 6d 65 28 20 24 74 69 6d | 65 70 2c 20 24 68 6f 73 |me( $tim|ep, $hos|
|00005cb0| 74 20 29 3b 0d 08 6f 64 | 0c fc a1 00 12 fa a1 00 |t );..od|........|
|00005cc0| 00 00 00 00 08 52 50 43 | 12 00 00 00 00 00 00 00 |.....RPC|........|
|00005cd0| 07 aa a1 00 18 fd a1 00 | 18 fd a1 00 00 00 00 00 |........|........|
|00005ce0| 00 6c 00 00 a5 48 00 00 | 40 00 00 00 a8 83 b6 ff |.l...H..|@.......|
|00005cf0| 68 90 b6 ff 00 00 00 00 | 0d 08 05 05 18 fe a1 00 |h.......|........|
|00005d00| 00 00 00 00 07 05 05 05 | 12 ff a1 00 12 ff a1 00 |........|........|
|00005d10| 00 00 00 00 07 05 05 05 | 0c 00 a2 00 12 ff a1 00 |........|........|
|00005d20| 0c 00 a2 00 00 00 00 00 | 00 48 00 00 a5 64 00 00 |........|.H...d..|
|00005d30| 40 70 05 03 a8 32 b6 ff | b8 59 b6 ff 70 1a 00 00 |@p...2..|.Y..p...|
|00005d40| 24 73 74 61 74 75 73 20 | 3d 20 72 70 63 62 5f 67 |$status |= rpcb_g|
|00005d50| 65 74 74 69 6d 65 28 20 | 24 74 69 6d 65 70 20 29 |ettime( |$timep )|
|00005d60| 3b 0d 08 05 0c 01 a2 00 | 12 ff a1 00 00 00 00 00 |;.......|........|
|00005d70| 08 08 05 05 12 00 00 00 | 00 00 00 00 07 05 05 05 |........|........|
|00005d80| 18 02 a2 00 18 02 a2 00 | 00 00 00 00 00 64 00 00 |........|.....d..|
|00005d90| a5 24 00 00 40 00 00 00 | 18 1e b6 ff d8 2a b6 ff |.$..@...|.....*..|
|00005da0| 00 00 00 00 0d 08 6f 64 | 18 03 a2 00 00 00 00 00 |......od|........|
|00005db0| 00 24 00 00 05 84 00 00 | 00 60 e3 07 48 c5 b5 ff |.$......|.`..H...|
|00005dc0| 28 f4 b5 ff 20 22 00 00 | 54 68 65 20 58 53 55 42 |(... "..|The XSUB|
|00005dd0| 20 77 69 6c 6c 20 6c 6f | 6f 6b 20 6c 69 6b 65 20 | will lo|ok like |
|00005de0| 74 68 65 20 63 6f 64 65 | 20 20 77 68 69 63 68 20 |the code| which |
|00005df0| 20 66 6f 6c 6c 6f 77 73 | 2e 20 20 20 41 20 20 43 | follows|. A C|
|00005e00| 4f 44 45 3a 20 62 6c 6f | 63 6b 20 20 69 73 20 75 |ODE: blo|ck is u|
|00005e10| 73 65 64 20 74 6f 20 63 | 61 6c 6c 20 74 68 65 20 |sed to c|all the |
|00005e20| 72 65 61 6c 20 72 70 63 | 62 5f 67 65 74 74 69 6d |real rpc|b_gettim|
|00005e30| 65 28 29 20 00 84 00 00 | a5 80 00 00 40 64 d3 04 |e() ....|....@d..|
|00005e40| 21 8d b5 ff 01 bc b5 ff | 20 22 00 00 66 75 6e 63 |!.......| "..func|
|00005e50| 74 69 6f 6e 20 77 69 74 | 68 20 74 68 65 20 70 61 |tion wit|h the pa|
|00005e60| 72 61 6d 65 74 65 72 73 | 20 69 6e 20 74 68 65 20 |rameters| in the |
|00005e70| 63 6f 72 72 65 63 74 20 | 6f 72 64 65 72 20 66 6f |correct |order fo|
|00005e80| 72 20 74 68 61 74 20 66 | 75 6e 63 74 69 6f 6e 2e |r that f|unction.|
|00005e90| 0d 07 65 20 12 04 a2 00 | 12 04 a2 00 00 00 00 00 |..e ....|........|
|00005ea0| 07 67 65 2e 0c 05 a2 00 | 12 04 a2 00 0c 05 a2 00 |.ge.....|........|
|00005eb0| 00 00 00 00 00 80 00 00 | 25 20 00 00 40 a0 8c 00 |........|% ..@...|
|00005ec0| 1a 26 b5 ff 2a 4d b5 ff | 70 1a 00 00 62 6f 6f 6c |.&..*M..|p...bool|
|00005ed0| 5f 74 0d 00 00 20 00 00 | 25 40 00 00 40 c0 4b 03 |_t... ..|%@..@.K.|
|00005ee0| 3a f7 b4 ff 4a 1e b5 ff | 70 1a 00 00 72 70 63 62 |:...J...|p...rpcb|
|00005ef0| 5f 67 65 74 74 69 6d 65 | 28 74 69 6d 65 70 2c 68 |_gettime|(timep,h|
|00005f00| 6f 73 74 3d 22 6c 6f 63 | 61 6c 68 6f 73 74 22 29 |ost="loc|alhost")|
|00005f10| 0d 00 00 00 00 40 00 00 | 25 28 00 00 40 90 5f 01 |.....@..|%(..@._.|
|00005f20| 5a c8 b4 ff 6a ef b4 ff | 70 1a 00 00 20 20 20 20 |Z...j...|p... |
|00005f30| 20 63 68 61 72 20 2a 68 | 6f 73 74 0d 00 28 00 00 | char *h|ost..(..|
|00005f40| 25 34 00 00 40 d0 78 02 | 7a 99 b4 ff 8a c0 b4 ff |%4..@.x.|z.......|
|00005f50| 70 1a 00 00 20 20 20 20 | 20 74 69 6d 65 5f 74 20 |p... | time_t |
|00005f60| 74 69 6d 65 70 20 3d 20 | 4e 4f 5f 49 4e 49 54 0d |timep = |NO_INIT.|
|00005f70| 00 34 00 00 25 24 00 00 | 40 60 ea 00 9a 6a b4 ff |.4..%$..|@`...j..|
|00005f80| aa 91 b4 ff 70 1a 00 00 | 20 20 20 20 20 43 4f 44 |....p...| COD|
|00005f90| 45 3a 0d 00 00 24 00 00 | 25 4c 00 00 40 00 65 04 |E:...$..|%L..@.e.|
|00005fa0| ba 3b b4 ff ca 62 b4 ff | 70 1a 00 00 20 20 20 20 |.;...b..|p... |
|00005fb0| 20 20 20 20 20 20 52 45 | 54 56 41 4c 20 3d 20 72 | RE|TVAL = r|
|00005fc0| 70 63 62 5f 67 65 74 74 | 69 6d 65 28 20 68 6f 73 |pcb_gett|ime( hos|
|00005fd0| 74 2c 20 26 74 69 6d 65 | 70 20 29 3b 0d 00 00 00 |t, &time|p );....|
|00005fe0| 00 4c 00 00 25 28 00 00 | 40 40 19 01 da 0c b4 ff |.L..%(..|@@......|
|00005ff0| ea 33 b4 ff 70 1a 00 00 | 20 20 20 20 20 4f 55 54 |.3..p...| OUT|
|00006000| 50 55 54 3a 0d 00 00 00 | 00 28 00 00 25 24 00 00 |PUT:....|.(..%$..|
|00006010| 40 60 ea 00 fa dd b3 ff | 0a 05 b4 ff 70 1a 00 00 |@`......|....p...|
|00006020| 20 20 20 20 20 74 69 6d | 65 70 0d 00 00 24 00 00 | tim|ep...$..|
|00006030| a5 50 00 00 40 d0 01 01 | 1a af b3 ff 2a d6 b3 ff |.P..@...|....*...|
|00006040| 70 1a 00 00 20 20 20 20 | 20 52 45 54 56 41 4c 0d |p... | RETVAL.|
|00006050| 08 6c 6f 77 0c 06 a2 00 | 12 04 a2 00 00 00 00 00 |.low....|........|
|00006060| 08 65 79 77 12 00 00 00 | 00 00 00 00 07 bf a1 00 |.eyw....|........|
|00006070| 18 07 a2 00 18 07 a2 00 | 00 00 00 00 00 50 00 00 |........|.....P..|
|00006080| a5 34 00 00 40 00 00 00 | 8a 9a b3 ff 4a a7 b3 ff |.4..@...|....J...|
|00006090| 00 00 00 00 0d 08 50 43 | 18 08 a2 00 00 00 00 00 |......PC|........|
|000060a0| 07 3d 20 72 0a 09 a2 00 | 0a 09 a2 00 00 00 00 00 |.= r....|........|
|000060b0| 00 34 00 00 01 10 00 00 | 41 3e 32 02 00 00 00 00 |.4......|A>2.....|
|000060c0| 00 10 00 00 02 18 00 00 | 70 0a 00 00 00 00 00 00 |........|p.......|
|000060d0| 0a 09 a2 00 00 00 00 00 | 00 18 00 00 a5 44 00 00 |........|.....D..|
|000060e0| 40 3e 32 02 8a 3e b1 ff | 3a 75 b1 ff 18 2b 00 00 |@>2..>..|:u...+..|
|000060f0| 16 00 00 00 b0 fc 07 00 | 00 00 00 00 54 68 65 20 |........|....The |
|00006100| 50 52 45 49 4e 49 54 3a | 20 4b 65 79 77 6f 72 64 |PREINIT:| Keyword|
|00006110| 0d 08 20 20 0a 0a a2 00 | 00 00 00 00 00 44 00 00 |.. ....|.....D..|
|00006120| 05 7c 00 00 00 d8 68 07 | 55 e9 b0 ff 35 18 b1 ff |.|....h.|U...5...|
|00006130| 20 22 00 00 54 68 65 20 | 50 52 45 49 4e 49 54 3a | "..The |PREINIT:|
|00006140| 20 6b 65 79 77 6f 72 64 | 20 61 6c 6c 6f 77 73 20 | keyword| allows |
|00006150| 65 78 74 72 61 20 76 61 | 72 69 61 62 6c 65 73 20 |extra va|riables |
|00006160| 74 6f 20 62 65 20 64 65 | 63 6c 61 72 65 64 20 62 |to be de|clared b|
|00006170| 65 66 6f 72 65 20 74 68 | 65 20 74 79 70 65 6d 61 |efore th|e typema|
|00006180| 70 73 20 61 72 65 20 65 | 78 70 61 6e 64 65 64 2e |ps are e|xpanded.|
|00006190| 20 20 49 66 20 61 20 00 | 00 7c 00 00 05 88 00 00 | If a .|.|......|
|000061a0| 00 cc ec 07 2e b1 b0 ff | 0e e0 b0 ff 20 22 00 00 |........|.... "..|
|000061b0| 76 61 72 69 61 62 6c 65 | 20 69 73 20 64 65 63 6c |variable| is decl|
|000061c0| 61 72 65 64 20 69 6e 20 | 61 20 43 4f 44 45 3a 20 |ared in |a CODE: |
|000061d0| 62 6c 6f 63 6b 20 74 68 | 65 6e 20 74 68 61 74 20 |block th|en that |
|000061e0| 76 61 72 69 61 62 6c 65 | 20 77 69 6c 6c 20 66 6f |variable| will fo|
|000061f0| 6c 6c 6f 77 20 61 6e 79 | 20 74 79 70 65 6d 61 70 |llow any| typemap|
|00006200| 20 63 6f 64 65 2e 20 20 | 54 68 69 73 20 6d 61 79 | code. |This may|
|00006210| 20 72 65 73 75 6c 74 20 | 69 6e 20 61 20 00 00 00 | result |in a ...|
|00006220| 00 88 00 00 05 80 00 00 | 00 40 7c 07 07 79 b0 ff |........|.@|..y..|
|00006230| e7 a7 b0 ff 20 22 00 00 | 43 20 73 79 6e 74 61 78 |.... "..|C syntax|
|00006240| 20 65 72 72 6f 72 2e 20 | 20 54 6f 20 66 6f 72 63 | error. | To forc|
|00006250| 65 20 74 68 65 20 76 61 | 72 69 61 62 6c 65 20 74 |e the va|riable t|
|00006260| 6f 20 62 65 20 64 65 63 | 6c 61 72 65 64 20 62 65 |o be dec|lared be|
|00006270| 66 6f 72 65 20 74 68 65 | 20 74 79 70 65 6d 61 70 |fore the| typemap|
|00006280| 20 63 6f 64 65 2c 20 70 | 6c 61 63 65 20 69 74 20 | code, p|lace it |
|00006290| 69 6e 74 6f 20 61 20 50 | 52 45 49 4e 49 54 3a 20 |into a P|REINIT: |
|000062a0| 00 80 00 00 25 64 00 00 | 40 b0 f2 05 e0 40 b0 ff |....%d..|@....@..|
|000062b0| c0 6f b0 ff 20 22 00 00 | 62 6c 6f 63 6b 2e 20 20 |.o.. "..|block. |
|000062c0| 54 68 65 20 50 52 45 49 | 4e 49 54 3a 20 6b 65 79 |The PREI|NIT: key|
|000062d0| 77 6f 72 64 20 6d 61 79 | 20 62 65 20 75 73 65 64 |word may| be used|
|000062e0| 20 6f 6e 65 20 6f 72 20 | 6d 6f 72 65 20 74 69 6d | one or |more tim|
|000062f0| 65 73 20 77 69 74 68 69 | 6e 20 61 6e 20 58 53 55 |es withi|n an XSU|
|00006300| 42 2e 0d 00 00 64 00 00 | 05 84 00 00 00 90 d7 07 |B....d..|........|
|00006310| 09 d2 af ff e9 00 b0 ff | 20 22 00 00 54 68 65 20 |........| "..The |
|00006320| 66 6f 6c 6c 6f 77 69 6e | 67 20 65 78 61 6d 70 6c |followin|g exampl|
|00006330| 65 73 20 61 72 65 20 65 | 71 75 69 76 61 6c 65 6e |es are e|quivalen|
|00006340| 74 2c 20 62 75 74 20 69 | 66 20 74 68 65 20 63 6f |t, but i|f the co|
|00006350| 64 65 20 69 73 20 75 73 | 69 6e 67 20 63 6f 6d 70 |de is us|ing comp|
|00006360| 6c 65 78 20 74 79 70 65 | 6d 61 70 73 20 74 68 65 |lex type|maps the|
|00006370| 6e 20 74 68 65 20 66 69 | 72 73 74 20 65 78 61 6d |n the fi|rst exam|
|00006380| 70 6c 65 20 69 73 20 00 | 00 84 00 00 a5 40 00 00 |ple is .|.....@..|
|00006390| 40 38 64 00 e2 99 af ff | c2 c8 af ff 20 22 00 00 |@8d.....|.... "..|
|000063a0| 73 61 66 65 72 2e 0d 07 | 12 0b a2 00 12 0b a2 00 |safer...|........|
|000063b0| 00 00 00 00 07 66 75 6e | 0c 0c a2 00 12 0b a2 00 |.....fun|........|
|000063c0| 0c 0c a2 00 00 00 00 00 | 00 40 00 00 25 20 00 00 |........|.@..% ..|
|000063d0| 40 a0 8c 00 db 32 af ff | eb 59 af ff 70 1a 00 00 |@....2..|.Y..p...|
|000063e0| 62 6f 6f 6c 5f 74 0d 00 | 00 20 00 00 25 2c 00 00 |bool_t..|. ..%,..|
|000063f0| 40 50 bd 01 fb 03 af ff | 0b 2b af ff 70 1a 00 00 |@P......|.+..p...|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
