/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume6 / rpc2 / part03

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 53 75 62 6a 65 63 74 3a | 20 20 76 30 36 69 30 39 |Subject:|  v06i09|
|00000010| 31 3a 20 20 53 75 6e 20 | 52 50 43 20 53 6f 75 72 |1:  Sun |RPC Sour|
|00000020| 63 65 20 28 72 70 63 32 | 29 2c 20 50 61 72 74 30 |ce (rpc2|), Part0|
|00000030| 33 2f 31 31 0a 4e 65 77 | 73 67 72 6f 75 70 73 3a |3/11.New|sgroups:|
|00000040| 20 6d 6f 64 2e 73 6f 75 | 72 63 65 73 0a 41 70 70 | mod.sou|rces.App|
|00000050| 72 6f 76 65 64 3a 20 72 | 73 40 6d 69 72 72 6f 72 |roved: r|s@mirror|
|00000060| 2e 55 55 43 50 0a 0a 53 | 75 62 6d 69 74 74 65 64 |.UUCP..S|ubmitted|
|00000070| 20 62 79 3a 20 63 63 61 | 21 53 55 4e 2e 43 4f 4d | by: cca|!SUN.COM|
|00000080| 21 6d 61 72 6b 73 20 28 | 4d 61 72 6b 20 53 74 65 |!marks (|Mark Ste|
|00000090| 69 6e 29 0a 4d 6f 64 2e | 73 6f 75 72 63 65 73 3a |in).Mod.|sources:|
|000000a0| 20 56 6f 6c 75 6d 65 20 | 36 2c 20 49 73 73 75 65 | Volume |6, Issue|
|000000b0| 20 39 31 0a 41 72 63 68 | 69 76 65 2d 6e 61 6d 65 | 91.Arch|ive-name|
|000000c0| 3a 20 72 70 63 32 2f 50 | 61 72 74 30 33 0a 0a 5b |: rpc2/P|art03..[|
|000000d0| 20 20 41 6c 6c 20 49 20 | 64 69 64 20 77 61 73 20 |  All I |did was |
|000000e0| 76 65 72 69 74 79 20 74 | 68 61 74 20 74 68 65 20 |verity t|hat the |
|000000f0| 73 68 61 72 20 66 69 6c | 65 73 20 75 6e 70 61 63 |shar fil|es unpac|
|00000100| 6b 65 64 20 63 6f 72 72 | 65 63 74 6c 79 2e 20 20 |ked corr|ectly.  |
|00000110| 2d 72 24 20 20 5d 0a 0a | 53 75 6e 20 52 50 43 20 |-r$  ]..|Sun RPC |
|00000120| 73 6f 75 72 63 65 20 28 | 70 61 72 74 20 33 20 6f |source (|part 3 o|
|00000130| 66 20 31 31 29 2e 20 20 | 54 68 69 73 20 73 6f 66 |f 11).  |This sof|
|00000140| 74 77 61 72 65 20 70 61 | 63 6b 61 67 65 20 63 6f |tware pa|ckage co|
|00000150| 6e 74 61 69 6e 73 20 63 | 6f 64 65 0a 61 6e 64 20 |ntains c|ode.and |
|00000160| 64 6f 63 75 6d 65 6e 74 | 61 74 69 6f 6e 20 66 6f |document|ation fo|
|00000170| 72 20 52 65 76 69 73 69 | 6f 6e 20 33 2e 30 20 6f |r Revisi|on 3.0 o|
|00000180| 66 20 74 68 65 20 53 75 | 6e 20 52 65 6d 6f 74 65 |f the Su|n Remote|
|00000190| 20 50 72 6f 63 65 64 75 | 72 65 20 43 61 6c 6c 0a | Procedu|re Call.|
|000001a0| 6c 69 62 72 61 72 79 2e | 20 20 49 6e 20 61 64 64 |library.|  In add|
|000001b0| 69 74 69 6f 6e 2c 20 61 | 20 62 65 74 61 20 76 65 |ition, a| beta ve|
|000001c0| 72 73 69 6f 6e 20 6f 66 | 20 74 68 65 20 58 44 52 |rsion of| the XDR|
|000001d0| 2f 52 50 43 20 70 72 6f | 74 6f 63 6f 6c 20 63 6f |/RPC pro|tocol co|
|000001e0| 6d 70 69 6c 65 72 0a 69 | 73 20 69 6e 63 6c 75 64 |mpiler.i|s includ|
|000001f0| 65 64 2e 20 20 43 6f 6d | 6d 65 6e 74 73 20 61 62 |ed.  Com|ments ab|
|00000200| 6f 75 74 20 74 68 69 73 | 20 6c 61 74 65 73 74 20 |out this| latest |
|00000210| 72 65 6c 65 61 73 65 20 | 6d 61 79 20 62 65 20 6d |release |may be m|
|00000220| 61 69 6c 65 64 20 74 6f | 0a 73 75 6e 21 72 70 63 |ailed to|.sun!rpc|
|00000230| 20 6f 72 20 72 70 63 40 | 73 75 6e 2e 63 6f 6d 2e | or rpc@|sun.com.|
|00000240| 0a 0a 53 75 6e 20 52 50 | 43 20 69 73 20 61 20 70 |..Sun RP|C is a p|
|00000250| 72 6f 64 75 63 74 20 6f | 66 20 53 75 6e 20 4d 69 |roduct o|f Sun Mi|
|00000260| 63 72 6f 73 79 73 74 65 | 6d 73 2c 20 49 6e 63 2e |crosyste|ms, Inc.|
|00000270| 20 61 6e 64 20 69 73 20 | 70 72 6f 76 69 64 65 64 | and is |provided|
|00000280| 20 66 6f 72 0a 75 6e 72 | 65 73 74 72 69 63 74 65 | for.unr|estricte|
|00000290| 64 20 75 73 65 20 70 72 | 6f 76 69 64 65 64 20 74 |d use pr|ovided t|
|000002a0| 68 61 74 20 74 68 69 73 | 20 6c 65 67 65 6e 64 20 |hat this| legend |
|000002b0| 69 73 20 69 6e 63 6c 75 | 64 65 64 20 6f 6e 20 61 |is inclu|ded on a|
|000002c0| 6c 6c 20 74 61 70 65 0a | 6d 65 64 69 61 20 61 6e |ll tape.|media an|
|000002d0| 64 20 61 73 20 61 20 70 | 61 72 74 20 6f 66 20 74 |d as a p|art of t|
|000002e0| 68 65 20 73 6f 66 74 77 | 61 72 65 20 70 72 6f 67 |he softw|are prog|
|000002f0| 72 61 6d 20 69 6e 20 77 | 68 6f 6c 65 20 6f 72 20 |ram in w|hole or |
|00000300| 70 61 72 74 2e 20 20 55 | 73 65 72 73 0a 6d 61 79 |part.  U|sers.may|
|00000310| 20 63 6f 70 79 20 6f 72 | 20 6d 6f 64 69 66 79 20 | copy or| modify |
|00000320| 53 75 6e 20 52 50 43 20 | 77 69 74 68 6f 75 74 20 |Sun RPC |without |
|00000330| 63 68 61 72 67 65 2c 20 | 62 75 74 20 61 72 65 20 |charge, |but are |
|00000340| 6e 6f 74 20 61 75 74 68 | 6f 72 69 7a 65 64 20 74 |not auth|orized t|
|00000350| 6f 0a 6c 69 63 65 6e 73 | 65 20 6f 72 20 64 69 73 |o.licens|e or dis|
|00000360| 74 72 69 62 75 74 65 20 | 69 74 20 74 6f 20 61 6e |tribute |it to an|
|00000370| 79 6f 6e 65 20 65 6c 73 | 65 20 65 78 63 65 70 74 |yone els|e except|
|00000380| 20 61 73 20 70 61 72 74 | 20 6f 66 20 61 20 70 72 | as part| of a pr|
|00000390| 6f 64 75 63 74 20 6f 72 | 0a 70 72 6f 67 72 61 6d |oduct or|.program|
|000003a0| 20 64 65 76 65 6c 6f 70 | 65 64 20 62 79 20 74 68 | develop|ed by th|
|000003b0| 65 20 75 73 65 72 2e 0a | 0a 2d 20 2d 20 2d 20 2d |e user..|.- - - -|
|000003c0| 20 2d 20 2d 20 2d 20 2d | 20 2d 20 43 20 55 20 54 | - - - -| - C U T|
|000003d0| 20 2d 20 48 20 45 20 52 | 20 45 20 2d 20 2d 20 2d | - H E R| E - - -|
|000003e0| 20 2d 20 2d 20 2d 20 2d | 20 2d 20 2d 20 2d 20 2d | - - - -| - - - -|
|000003f0| 20 2d 20 2d 20 2d 20 2d | 20 2d 20 2d 20 2d 0a 23 | - - - -| - - -.#|
|00000400| 21 20 2f 62 69 6e 2f 73 | 68 0a 23 20 54 68 69 73 |! /bin/s|h.# This|
|00000410| 20 69 73 20 61 20 73 68 | 65 6c 6c 20 61 72 63 68 | is a sh|ell arch|
|00000420| 69 76 65 2c 20 6d 65 61 | 6e 69 6e 67 3a 0a 23 20 |ive, mea|ning:.# |
|00000430| 31 2e 20 52 65 6d 6f 76 | 65 20 65 76 65 72 79 74 |1. Remov|e everyt|
|00000440| 68 69 6e 67 20 61 62 6f | 76 65 20 74 68 65 20 23 |hing abo|ve the #|
|00000450| 21 20 2f 62 69 6e 2f 73 | 68 20 6c 69 6e 65 2e 0a |! /bin/s|h line..|
|00000460| 23 20 32 2e 20 53 61 76 | 65 20 74 68 65 20 72 65 |# 2. Sav|e the re|
|00000470| 73 75 6c 74 69 6e 67 20 | 74 65 78 74 20 69 6e 20 |sulting |text in |
|00000480| 61 20 66 69 6c 65 2e 0a | 23 20 33 2e 20 45 78 65 |a file..|# 3. Exe|
|00000490| 63 75 74 65 20 74 68 65 | 20 66 69 6c 65 20 77 69 |cute the| file wi|
|000004a0| 74 68 20 2f 62 69 6e 2f | 73 68 20 28 6e 6f 74 20 |th /bin/|sh (not |
|000004b0| 63 73 68 29 20 74 6f 20 | 63 72 65 61 74 65 3a 0a |csh) to |create:.|
|000004c0| 23 09 72 70 63 2f 64 6f | 63 2f 78 64 72 2e 73 70 |#.rpc/do|c/xdr.sp|
|000004d0| 65 63 2e 70 31 0a 23 20 | 54 68 69 73 20 61 72 63 |ec.p1.# |This arc|
|000004e0| 68 69 76 65 20 63 72 65 | 61 74 65 64 3a 20 4d 6f |hive cre|ated: Mo|
|000004f0| 6e 20 4a 75 6c 20 31 34 | 20 31 36 3a 35 35 3a 30 |n Jul 14| 16:55:0|
|00000500| 33 20 31 39 38 36 0a 65 | 78 70 6f 72 74 20 50 41 |3 1986.e|xport PA|
|00000510| 54 48 3b 20 50 41 54 48 | 3d 2f 62 69 6e 3a 2f 75 |TH; PATH|=/bin:/u|
|00000520| 73 72 2f 62 69 6e 3a 24 | 50 41 54 48 0a 66 6f 72 |sr/bin:$|PATH.for|
|00000530| 20 64 20 69 6e 20 72 70 | 63 20 72 70 63 2f 64 6f | d in rp|c rpc/do|
|00000540| 63 20 72 70 63 2f 72 70 | 63 6c 69 62 20 72 70 63 |c rpc/rp|clib rpc|
|00000550| 2f 74 6f 6f 6c 73 20 72 | 70 63 2f 74 6f 79 73 20 |/tools r|pc/toys |
|00000560| 72 70 63 2f 72 70 63 6c | 69 62 2f 70 72 6f 66 69 |rpc/rpcl|ib/profi|
|00000570| 6c 65 64 20 72 70 63 2f | 72 70 63 67 65 6e 20 72 |led rpc/|rpcgen r|
|00000580| 70 63 2f 72 70 63 67 65 | 6e 2f 74 65 73 74 0a 64 |pc/rpcge|n/test.d|
|00000590| 6f 0a 09 69 66 20 74 65 | 73 74 20 21 20 2d 64 20 |o..if te|st ! -d |
|000005a0| 24 64 0a 09 74 68 65 6e | 0a 09 09 65 63 68 6f 20 |$d..then|...echo |
|000005b0| 22 73 68 61 72 3a 20 4d | 61 6b 69 6e 67 20 64 69 |"shar: M|aking di|
|000005c0| 72 65 63 74 6f 72 79 20 | 24 64 22 0a 09 09 6d 6b |rectory |$d"...mk|
|000005d0| 64 69 72 20 24 64 0a 09 | 09 63 68 6d 6f 64 20 37 |dir $d..|.chmod 7|
|000005e0| 35 35 20 24 64 0a 09 66 | 69 0a 64 6f 6e 65 0a 65 |55 $d..f|i.done.e|
|000005f0| 63 68 6f 20 73 68 61 72 | 3a 20 22 65 78 74 72 61 |cho shar|: "extra|
|00000600| 63 74 69 6e 67 20 27 72 | 70 63 2f 64 6f 63 2f 78 |cting 'r|pc/doc/x|
|00000610| 64 72 2e 73 70 65 63 2e | 70 31 27 22 20 27 28 34 |dr.spec.|p1'" '(4|
|00000620| 39 38 30 39 20 63 68 61 | 72 61 63 74 65 72 73 29 |9809 cha|racters)|
|00000630| 27 0a 69 66 20 74 65 73 | 74 20 2d 66 20 27 72 70 |'.if tes|t -f 'rp|
|00000640| 63 2f 64 6f 63 2f 78 64 | 72 2e 73 70 65 63 2e 70 |c/doc/xd|r.spec.p|
|00000650| 31 27 0a 74 68 65 6e 0a | 09 65 63 68 6f 20 73 68 |1'.then.|.echo sh|
|00000660| 61 72 3a 20 22 77 69 6c | 6c 20 6e 6f 74 20 6f 76 |ar: "wil|l not ov|
|00000670| 65 72 2d 77 72 69 74 65 | 20 65 78 69 73 74 69 6e |er-write| existin|
|00000680| 67 20 66 69 6c 65 20 27 | 72 70 63 2f 64 6f 63 2f |g file '|rpc/doc/|
|00000690| 78 64 72 2e 73 70 65 63 | 2e 70 31 27 22 0a 65 6c |xdr.spec|.p1'".el|
|000006a0| 73 65 0a 73 65 64 20 27 | 73 2f 5e 58 2f 2f 27 20 |se.sed '|s/^X//' |
|000006b0| 3c 3c 20 5c 53 48 41 52 | 5f 45 4f 46 20 3e 20 27 |<< \SHAR|_EOF > '|
|000006c0| 72 70 63 2f 64 6f 63 2f | 78 64 72 2e 73 70 65 63 |rpc/doc/|xdr.spec|
|000006d0| 2e 70 31 27 0a 58 2e 5c | 22 20 40 28 23 29 63 33 |.p1'.X.\|" @(#)c3|
|000006e0| 2e 78 64 72 2e 73 70 65 | 63 20 31 2e 31 20 38 36 |.xdr.spe|c 1.1 86|
|000006f0| 2f 30 32 2f 32 35 20 53 | 4d 49 3b 20 66 6f 72 20 |/02/25 S|MI; for |
|00000700| 33 2e 30 20 46 43 53 0a | 58 2e 50 4c 20 52 49 47 |3.0 FCS.|X.PL RIG|
|00000710| 48 54 0a 58 2e 45 51 0a | 58 64 65 6c 69 6d 20 24 |HT.X.EQ.|Xdelim $|
|00000720| 24 0a 58 2e 45 4e 0a 58 | 2e 54 4c 0a 58 45 78 74 |$.X.EN.X|.TL.XExt|
|00000730| 65 72 6e 61 6c 20 44 61 | 74 61 20 52 65 70 72 65 |ernal Da|ta Repre|
|00000740| 73 65 6e 74 61 74 69 6f | 6e 0a 58 2e 62 72 0a 58 |sentatio|n.X.br.X|
|00000750| 50 72 6f 74 6f 63 6f 6c | 20 53 70 65 63 69 66 69 |Protocol| Specifi|
|00000760| 63 61 74 69 6f 6e 0a 58 | 2e 62 70 0a 58 2e 4e 48 |cation.X|.bp.X.NH|
|00000770| 0a 58 49 6e 74 72 6f 64 | 75 63 74 69 6f 6e 0a 58 |.XIntrod|uction.X|
|00000780| 2e 4c 50 0a 58 54 68 69 | 73 20 6d 61 6e 75 61 6c |.LP.XThi|s manual|
|00000790| 20 64 65 73 63 72 69 62 | 65 73 20 6c 69 62 72 61 | describ|es libra|
|000007a0| 72 79 20 72 6f 75 74 69 | 6e 65 73 20 74 68 61 74 |ry routi|nes that|
|000007b0| 20 61 6c 6c 6f 77 20 61 | 20 43 20 70 72 6f 67 72 | allow a| C progr|
|000007c0| 61 6d 6d 65 72 20 74 6f | 20 0a 58 64 65 73 63 72 |ammer to| .Xdescr|
|000007d0| 69 62 65 20 61 72 62 69 | 74 72 61 72 79 20 64 61 |ibe arbi|trary da|
|000007e0| 74 61 20 73 74 72 75 63 | 74 75 72 65 73 20 69 6e |ta struc|tures in|
|000007f0| 20 61 20 6d 61 63 68 69 | 6e 65 2d 69 6e 64 65 70 | a machi|ne-indep|
|00000800| 65 6e 64 65 6e 74 20 66 | 61 73 68 69 6f 6e 2e 0a |endent f|ashion..|
|00000810| 58 54 68 65 20 65 58 74 | 65 72 6e 61 6c 20 44 61 |XThe eXt|ernal Da|
|00000820| 74 61 20 52 65 70 72 65 | 73 65 6e 74 61 74 69 6f |ta Repre|sentatio|
|00000830| 6e 20 28 58 44 52 29 20 | 73 74 61 6e 64 61 72 64 |n (XDR) |standard|
|00000840| 0a 58 69 73 20 74 68 65 | 20 62 61 63 6b 62 6f 6e |.Xis the| backbon|
|00000850| 65 20 6f 66 20 53 75 6e | 27 73 20 52 65 6d 6f 74 |e of Sun|'s Remot|
|00000860| 65 20 50 72 6f 63 65 64 | 75 72 65 20 43 61 6c 6c |e Proced|ure Call|
|00000870| 20 70 61 63 6b 61 67 65 | 2c 0a 58 69 6e 20 74 68 | package|,.Xin th|
|00000880| 65 20 73 65 6e 73 65 20 | 74 68 61 74 20 64 61 74 |e sense |that dat|
|00000890| 61 20 66 6f 72 20 72 65 | 6d 6f 74 65 20 70 72 6f |a for re|mote pro|
|000008a0| 63 65 64 75 72 65 20 63 | 61 6c 6c 73 0a 58 69 73 |cedure c|alls.Xis|
|000008b0| 20 74 72 61 6e 73 6d 69 | 74 74 65 64 20 75 73 69 | transmi|tted usi|
|000008c0| 6e 67 20 74 68 65 20 73 | 74 61 6e 64 61 72 64 2e |ng the s|tandard.|
|000008d0| 0a 58 58 44 52 20 6c 69 | 62 72 61 72 79 20 72 6f |.XXDR li|brary ro|
|000008e0| 75 74 69 6e 65 73 20 73 | 68 6f 75 6c 64 20 62 65 |utines s|hould be|
|000008f0| 20 75 73 65 64 20 74 6f | 20 74 72 61 6e 73 6d 69 | used to| transmi|
|00000900| 74 20 64 61 74 61 0a 58 | 74 68 61 74 20 69 73 20 |t data.X|that is |
|00000910| 61 63 63 65 73 73 65 64 | 20 28 72 65 61 64 20 6f |accessed| (read o|
|00000920| 72 20 77 72 69 74 74 65 | 6e 29 20 62 79 20 6d 6f |r writte|n) by mo|
|00000930| 72 65 20 74 68 61 6e 20 | 6f 6e 65 20 74 79 70 65 |re than |one type|
|00000940| 20 6f 66 20 6d 61 63 68 | 69 6e 65 2e 0a 58 2e 4c | of mach|ine..X.L|
|00000950| 50 0a 58 54 68 69 73 20 | 6d 61 6e 75 61 6c 20 63 |P.XThis |manual c|
|00000960| 6f 6e 74 61 69 6e 73 20 | 61 20 64 65 73 63 72 69 |ontains |a descri|
|00000970| 70 74 69 6f 6e 20 6f 66 | 20 58 44 52 20 6c 69 62 |ption of| XDR lib|
|00000980| 72 61 72 79 20 72 6f 75 | 74 69 6e 65 73 2c 0a 58 |rary rou|tines,.X|
|00000990| 61 20 67 75 69 64 65 20 | 74 6f 20 61 63 63 65 73 |a guide |to acces|
|000009a0| 73 69 6e 67 20 63 75 72 | 72 65 6e 74 6c 79 20 61 |sing cur|rently a|
|000009b0| 76 61 69 6c 61 62 6c 65 | 20 58 44 52 20 73 74 72 |vailable| XDR str|
|000009c0| 65 61 6d 73 2c 0a 58 69 | 6e 66 6f 72 6d 61 74 69 |eams,.Xi|nformati|
|000009d0| 6f 6e 20 6f 6e 20 64 65 | 66 69 6e 69 6e 67 20 6e |on on de|fining n|
|000009e0| 65 77 20 73 74 72 65 61 | 6d 73 20 61 6e 64 20 64 |ew strea|ms and d|
|000009f0| 61 74 61 20 74 79 70 65 | 73 2c 0a 58 61 6e 64 20 |ata type|s,.Xand |
|00000a00| 61 20 66 6f 72 6d 61 6c | 20 64 65 66 69 6e 69 74 |a formal| definit|
|00000a10| 69 6f 6e 20 6f 66 20 74 | 68 65 20 58 44 52 20 73 |ion of t|he XDR s|
|00000a20| 74 61 6e 64 61 72 64 2e | 0a 58 58 44 52 20 77 61 |tandard.|.XXDR wa|
|00000a30| 73 20 64 65 73 69 67 6e | 65 64 20 74 6f 20 77 6f |s design|ed to wo|
|00000a40| 72 6b 20 61 63 72 6f 73 | 73 20 64 69 66 66 65 72 |rk acros|s differ|
|00000a50| 65 6e 74 20 6c 61 6e 67 | 75 61 67 65 73 2c 0a 58 |ent lang|uages,.X|
|00000a60| 6f 70 65 72 61 74 69 6e | 67 20 73 79 73 74 65 6d |operatin|g system|
|00000a70| 73 2c 20 61 6e 64 20 6d | 61 63 68 69 6e 65 20 61 |s, and m|achine a|
|00000a80| 72 63 68 69 74 65 63 74 | 75 72 65 73 2e 0a 58 4d |rchitect|ures..XM|
|00000a90| 6f 73 74 20 75 73 65 72 | 73 20 28 70 61 72 74 69 |ost user|s (parti|
|00000aa0| 63 75 6c 61 72 6c 79 20 | 52 50 43 20 75 73 65 72 |cularly |RPC user|
|00000ab0| 73 29 0a 58 6f 6e 6c 79 | 20 6e 65 65 64 20 74 68 |s).Xonly| need th|
|00000ac0| 65 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 20 69 6e |e inform|ation in|
|00000ad0| 20 73 65 63 74 69 6f 6e | 73 20 32 20 61 6e 64 20 | section|s 2 and |
|00000ae0| 33 20 6f 66 20 74 68 69 | 73 20 64 6f 63 75 6d 65 |3 of thi|s docume|
|00000af0| 6e 74 2e 0a 58 50 72 6f | 67 72 61 6d 6d 65 72 73 |nt..XPro|grammers|
|00000b00| 20 77 69 73 68 69 6e 67 | 20 74 6f 20 69 6d 70 6c | wishing| to impl|
|00000b10| 65 6d 65 6e 74 20 52 50 | 43 20 61 6e 64 20 58 44 |ement RP|C and XD|
|00000b20| 52 20 6f 6e 20 6e 65 77 | 20 6d 61 63 68 69 6e 65 |R on new| machine|
|00000b30| 73 0a 58 77 69 6c 6c 20 | 6e 65 65 64 20 74 68 65 |s.Xwill |need the|
|00000b40| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 20 69 6e 20 | informa|tion in |
|00000b50| 73 65 63 74 69 6f 6e 73 | 20 34 20 74 68 72 6f 75 |sections| 4 throu|
|00000b60| 67 68 20 36 2e 0a 58 41 | 64 76 61 6e 63 65 64 20 |gh 6..XA|dvanced |
|00000b70| 74 6f 70 69 63 73 2c 20 | 6e 6f 74 20 6e 65 63 65 |topics, |not nece|
|00000b80| 73 73 61 72 79 20 66 6f | 72 20 61 6c 6c 20 69 6d |ssary fo|r all im|
|00000b90| 70 6c 65 6d 65 6e 74 61 | 74 69 6f 6e 73 2c 0a 58 |plementa|tions,.X|
|00000ba0| 61 72 65 20 63 6f 76 65 | 72 65 64 20 69 6e 20 73 |are cove|red in s|
|00000bb0| 65 63 74 69 6f 6e 20 37 | 2e 0a 58 2e 4c 50 0a 58 |ection 7|..X.LP.X|
|00000bc0| 4f 6e 20 53 75 6e 20 73 | 79 73 74 65 6d 73 2c 0a |On Sun s|ystems,.|
|00000bd0| 58 43 20 70 72 6f 67 72 | 61 6d 73 20 74 68 61 74 |XC progr|ams that|
|00000be0| 20 77 61 6e 74 20 74 6f | 20 75 73 65 20 58 44 52 | want to| use XDR|
|00000bf0| 20 72 6f 75 74 69 6e 65 | 73 0a 58 6d 75 73 74 20 | routine|s.Xmust |
|00000c00| 69 6e 63 6c 75 64 65 20 | 74 68 65 20 66 69 6c 65 |include |the file|
|00000c10| 0a 58 2e 4c 57 20 3c 72 | 70 63 2f 72 70 63 2e 68 |.X.LW <r|pc/rpc.h|
|00000c20| 3e 20 2c 0a 58 77 68 69 | 63 68 20 63 6f 6e 74 61 |> ,.Xwhi|ch conta|
|00000c30| 69 6e 73 20 61 6c 6c 20 | 74 68 65 20 6e 65 63 65 |ins all |the nece|
|00000c40| 73 73 61 72 79 20 69 6e | 74 65 72 66 61 63 65 73 |ssary in|terfaces|
|00000c50| 20 74 6f 20 74 68 65 20 | 58 44 52 20 73 79 73 74 | to the |XDR syst|
|00000c60| 65 6d 2e 0a 58 53 69 6e | 63 65 20 74 68 65 20 43 |em..XSin|ce the C|
|00000c70| 20 6c 69 62 72 61 72 79 | 0a 58 2e 4c 57 20 6c 69 | library|.X.LW li|
|00000c80| 62 63 2e 61 0a 58 63 6f | 6e 74 61 69 6e 73 20 61 |bc.a.Xco|ntains a|
|00000c90| 6c 6c 20 74 68 65 20 58 | 44 52 20 72 6f 75 74 69 |ll the X|DR routi|
|00000ca0| 6e 65 73 2c 0a 58 63 6f | 6d 70 69 6c 65 20 61 73 |nes,.Xco|mpile as|
|00000cb0| 20 6e 6f 72 6d 61 6c 2e | 0a 58 2e 4c 53 0a 58 25 | normal.|.X.LS.X%|
|00000cc0| 20 5c 66 28 4c 42 63 63 | 5c 30 5c 66 49 70 72 6f | \f(LBcc|\0\fIpro|
|00000cd0| 67 72 61 6d 5c 66 50 2e | 63 5c 66 4c 0a 58 2e 4c |gram\fP.|c\fL.X.L|
|00000ce0| 66 0a 58 2e 4e 48 20 32 | 0a 58 4a 75 73 74 69 66 |f.X.NH 2|.XJustif|
|00000cf0| 69 63 61 74 69 6f 6e 0a | 58 2e 4c 50 0a 58 43 6f |ication.|X.LP.XCo|
|00000d00| 6e 73 69 64 65 72 20 74 | 68 65 20 66 6f 6c 6c 6f |nsider t|he follo|
|00000d10| 77 69 6e 67 20 74 77 6f | 20 70 72 6f 67 72 61 6d |wing two| program|
|00000d20| 73 2c 0a 58 2e 4c 57 20 | 77 72 69 74 65 72 20 3a |s,.X.LW |writer :|
|00000d30| 0a 58 2e 4c 53 0a 58 23 | 69 6e 63 6c 75 64 65 20 |.X.LS.X#|include |
|00000d40| 3c 73 74 64 69 6f 2e 68 | 3e 0a 58 2e 73 70 2e 35 |<stdio.h|>.X.sp.5|
|00000d50| 0a 58 6d 61 69 6e 28 29 | 09 09 09 2f 2a 20 77 72 |.Xmain()|.../* wr|
|00000d60| 69 74 65 72 2e 63 20 2a | 2f 0a 58 7b 0a 58 09 6c |iter.c *|/.X{.X.l|
|00000d70| 6f 6e 67 20 69 3b 0a 58 | 2e 73 70 2e 35 0a 58 09 |ong i;.X|.sp.5.X.|
|00000d80| 66 6f 72 20 28 69 20 3d | 20 30 3b 20 69 20 3c 20 |for (i =| 0; i < |
|00000d90| 38 3b 20 69 2b 2b 29 20 | 7b 0a 58 09 09 69 66 20 |8; i++) |{.X..if |
|00000da0| 28 66 77 72 69 74 65 28 | 28 63 68 61 72 20 2a 29 |(fwrite(|(char *)|
|00000db0| 26 69 2c 20 73 69 7a 65 | 6f 66 28 69 29 2c 20 31 |&i, size|of(i), 1|
|00000dc0| 2c 20 73 74 64 6f 75 74 | 29 20 21 3d 20 31 29 20 |, stdout|) != 1) |
|00000dd0| 7b 0a 58 09 09 09 66 70 | 72 69 6e 74 66 28 73 74 |{.X...fp|rintf(st|
|00000de0| 64 65 72 72 2c 20 22 66 | 61 69 6c 65 64 21 5c 65 |derr, "f|ailed!\e|
|00000df0| 6e 22 29 3b 0a 58 09 09 | 09 65 78 69 74 28 31 29 |n");.X..|.exit(1)|
|00000e00| 3b 0a 58 09 09 7d 0a 58 | 09 7d 0a 58 7d 0a 58 2e |;.X..}.X|.}.X}.X.|
|00000e10| 4c 66 0a 58 61 6e 64 0a | 58 2e 4c 57 20 72 65 61 |Lf.Xand.|X.LW rea|
|00000e20| 64 65 72 20 3a 0a 58 2e | 4c 53 0a 58 23 69 6e 63 |der :.X.|LS.X#inc|
|00000e30| 6c 75 64 65 20 3c 73 74 | 64 69 6f 2e 68 3e 0a 58 |lude <st|dio.h>.X|
|00000e40| 2e 73 70 2e 35 0a 58 6d | 61 69 6e 28 29 09 09 09 |.sp.5.Xm|ain()...|
|00000e50| 2f 2a 20 72 65 61 64 65 | 72 2e 63 20 2a 2f 0a 58 |/* reade|r.c */.X|
|00000e60| 7b 0a 58 09 6c 6f 6e 67 | 20 69 2c 20 6a 3b 0a 58 |{.X.long| i, j;.X|
|00000e70| 2e 73 70 2e 35 0a 58 09 | 66 6f 72 20 28 6a 20 3d |.sp.5.X.|for (j =|
|00000e80| 20 30 3b 20 6a 20 3c 20 | 38 3b 20 6a 2b 2b 29 20 | 0; j < |8; j++) |
|00000e90| 7b 0a 58 09 09 69 66 20 | 28 66 72 65 61 64 28 28 |{.X..if |(fread((|
|00000ea0| 63 68 61 72 20 2a 29 26 | 69 2c 20 73 69 7a 65 6f |char *)&|i, sizeo|
|00000eb0| 66 20 28 69 29 2c 20 31 | 2c 20 73 74 64 69 6e 29 |f (i), 1|, stdin)|
|00000ec0| 20 21 3d 20 31 29 20 7b | 0a 58 09 09 09 66 70 72 | != 1) {|.X...fpr|
|00000ed0| 69 6e 74 66 28 73 74 64 | 65 72 72 2c 20 22 66 61 |intf(std|err, "fa|
|00000ee0| 69 6c 65 64 21 5c 65 6e | 22 29 3b 0a 58 09 09 09 |iled!\en|");.X...|
|00000ef0| 65 78 69 74 28 31 29 3b | 0a 58 09 09 7d 0a 58 09 |exit(1);|.X..}.X.|
|00000f00| 09 70 72 69 6e 74 66 28 | 22 25 6c 64 20 22 2c 20 |.printf(|"%ld ", |
|00000f10| 69 29 3b 0a 58 09 7d 0a | 58 09 70 72 69 6e 74 66 |i);.X.}.|X.printf|
|00000f20| 28 22 5c 65 6e 22 29 3b | 0a 58 7d 0a 58 2e 4c 66 |("\en");|.X}.X.Lf|
|00000f30| 0a 58 54 68 65 20 74 77 | 6f 20 70 72 6f 67 72 61 |.XThe tw|o progra|
|00000f40| 6d 73 20 61 70 70 65 61 | 72 20 74 6f 20 62 65 20 |ms appea|r to be |
|00000f50| 70 6f 72 74 61 62 6c 65 | 2c 20 62 65 63 61 75 73 |portable|, becaus|
|00000f60| 65 0a 58 28 61 29 20 74 | 68 65 79 20 70 61 73 73 |e.X(a) t|hey pass|
|00000f70| 0a 58 2e 4c 57 20 6c 69 | 6e 74 0a 58 63 68 65 63 |.X.LW li|nt.Xchec|
|00000f80| 6b 69 6e 67 2c 20 61 6e | 64 0a 58 28 62 29 20 74 |king, an|d.X(b) t|
|00000f90| 68 65 79 20 65 78 68 69 | 62 69 74 20 74 68 65 20 |hey exhi|bit the |
|00000fa0| 73 61 6d 65 20 62 65 68 | 61 76 69 6f 72 20 77 68 |same beh|avior wh|
|00000fb0| 65 6e 20 65 78 65 63 75 | 74 65 64 0a 58 6f 6e 20 |en execu|ted.Xon |
|00000fc0| 74 77 6f 20 64 69 66 66 | 65 72 65 6e 74 20 68 61 |two diff|erent ha|
|00000fd0| 72 64 77 61 72 65 20 61 | 72 63 68 69 74 65 63 74 |rdware a|rchitect|
|00000fe0| 75 72 65 73 2c 20 61 20 | 53 75 6e 20 61 6e 64 20 |ures, a |Sun and |
|00000ff0| 61 20 56 41 58 2e 0a 58 | 2e 4c 50 0a 58 50 69 70 |a VAX..X|.LP.XPip|
|00001000| 69 6e 67 20 74 68 65 20 | 6f 75 74 70 75 74 20 6f |ing the |output o|
|00001010| 66 20 74 68 65 0a 58 2e | 4c 57 20 77 72 69 74 65 |f the.X.|LW write|
|00001020| 72 0a 58 70 72 6f 67 72 | 61 6d 20 74 6f 20 74 68 |r.Xprogr|am to th|
|00001030| 65 0a 58 2e 4c 57 20 72 | 65 61 64 65 72 0a 58 70 |e.X.LW r|eader.Xp|
|00001040| 72 6f 67 72 61 6d 20 67 | 69 76 65 73 20 69 64 65 |rogram g|ives ide|
|00001050| 6e 74 69 63 61 6c 20 72 | 65 73 75 6c 74 73 20 6f |ntical r|esults o|
|00001060| 6e 20 61 20 53 75 6e 20 | 6f 72 20 61 20 56 41 58 |n a Sun |or a VAX|
|00001070| 2e 5c 28 64 64 0a 58 2e | 46 53 20 5c 28 64 64 0a |.\(dd.X.|FS \(dd.|
|00001080| 58 56 41 58 20 69 73 20 | 61 20 74 72 61 64 65 6d |XVAX is |a tradem|
|00001090| 61 72 6b 20 6f 66 20 44 | 69 67 69 74 61 6c 20 45 |ark of D|igital E|
|000010a0| 71 75 69 70 6d 65 6e 74 | 20 43 6f 72 70 6f 72 61 |quipment| Corpora|
|000010b0| 74 69 6f 6e 2e 0a 58 2e | 46 45 0a 58 2e 4c 53 0a |tion..X.|FE.X.LS.|
|000010c0| 58 73 75 6e 25 20 77 72 | 69 74 65 72 20 7c 20 72 |Xsun% wr|iter | r|
|000010d0| 65 61 64 65 72 0a 58 30 | 20 31 20 32 20 33 20 34 |eader.X0| 1 2 3 4|
|000010e0| 20 35 20 36 20 37 0a 58 | 73 75 6e 25 0a 58 2e 4c | 5 6 7.X|sun%.X.L|
|000010f0| 66 0a 58 2e 4c 53 0a 58 | 76 61 78 25 20 77 72 69 |f.X.LS.X|vax% wri|
|00001100| 74 65 72 20 7c 20 72 65 | 61 64 65 72 0a 58 30 20 |ter | re|ader.X0 |
|00001110| 31 20 32 20 33 20 34 20 | 35 20 36 20 37 0a 58 76 |1 2 3 4 |5 6 7.Xv|
|00001120| 61 78 25 0a 58 2e 4c 66 | 0a 58 57 69 74 68 20 74 |ax%.X.Lf|.XWith t|
|00001130| 68 65 20 61 64 76 65 6e | 74 20 6f 66 20 6c 6f 63 |he adven|t of loc|
|00001140| 61 6c 20 61 72 65 61 20 | 6e 65 74 77 6f 72 6b 73 |al area |networks|
|00001150| 20 61 6e 64 20 42 65 72 | 6b 65 6c 65 79 27 73 20 | and Ber|keley's |
|00001160| 34 2e 32 20 42 53 44 0a | 58 2e 55 58 0a 58 63 61 |4.2 BSD.|X.UX.Xca|
|00001170| 6d 65 20 74 68 65 20 63 | 6f 6e 63 65 70 74 20 6f |me the c|oncept o|
|00001180| 66 20 60 60 6e 65 74 77 | 6f 72 6b 20 70 69 70 65 |f ``netw|ork pipe|
|00001190| 73 27 27 20 5c 28 65 6d | 0a 58 61 20 70 72 6f 63 |s'' \(em|.Xa proc|
|000011a0| 65 73 73 20 70 72 6f 64 | 75 63 65 73 20 64 61 74 |ess prod|uces dat|
|000011b0| 61 20 6f 6e 20 6f 6e 65 | 20 6d 61 63 68 69 6e 65 |a on one| machine|
|000011c0| 2c 0a 58 61 6e 64 20 61 | 20 73 65 63 6f 6e 64 20 |,.Xand a| second |
|000011d0| 70 72 6f 63 65 73 73 20 | 63 6f 6e 73 75 6d 65 73 |process |consumes|
|000011e0| 20 64 61 74 61 20 6f 6e | 20 61 6e 6f 74 68 65 72 | data on| another|
|000011f0| 20 6d 61 63 68 69 6e 65 | 2e 0a 58 41 20 6e 65 74 | machine|..XA net|
|00001200| 77 6f 72 6b 20 70 69 70 | 65 20 63 61 6e 20 62 65 |work pip|e can be|
|00001210| 20 63 6f 6e 73 74 72 75 | 63 74 65 64 20 77 69 74 | constru|cted wit|
|00001220| 68 0a 58 2e 4c 57 20 77 | 72 69 74 65 72 0a 58 61 |h.X.LW w|riter.Xa|
|00001230| 6e 64 0a 58 2e 4c 57 20 | 72 65 61 64 65 72 20 2e |nd.X.LW |reader .|
|00001240| 0a 58 48 65 72 65 20 61 | 72 65 20 74 68 65 20 72 |.XHere a|re the r|
|00001250| 65 73 75 6c 74 73 20 69 | 66 20 74 68 65 20 66 69 |esults i|f the fi|
|00001260| 72 73 74 20 70 72 6f 64 | 75 63 65 73 20 64 61 74 |rst prod|uces dat|
|00001270| 61 20 6f 6e 20 61 20 53 | 75 6e 2c 0a 58 61 6e 64 |a on a S|un,.Xand|
|00001280| 20 74 68 65 20 73 65 63 | 6f 6e 64 20 63 6f 6e 73 | the sec|ond cons|
|00001290| 75 6d 65 73 20 64 61 74 | 61 20 6f 6e 20 61 20 56 |umes dat|a on a V|
|000012a0| 41 58 2e 0a 58 2e 4c 53 | 0a 58 73 75 6e 25 20 77 |AX..X.LS|.Xsun% w|
|000012b0| 72 69 74 65 72 20 7c 20 | 72 73 68 20 76 61 78 20 |riter | |rsh vax |
|000012c0| 72 65 61 64 65 72 0a 58 | 30 20 31 36 37 37 37 32 |reader.X|0 167772|
|000012d0| 31 36 20 33 33 35 35 34 | 34 33 32 20 35 30 33 33 |16 33554|432 5033|
|000012e0| 31 36 34 38 20 36 37 31 | 30 38 38 36 34 20 38 33 |1648 671|08864 83|
|000012f0| 38 38 36 30 38 30 20 31 | 30 30 36 36 33 32 39 36 |886080 1|00663296|
|00001300| 0a 58 31 31 37 34 34 30 | 35 31 32 0a 58 73 75 6e |.X117440|512.Xsun|
|00001310| 25 0a 58 2e 4c 66 0a 58 | 49 64 65 6e 74 69 63 61 |%.X.Lf.X|Identica|
|00001320| 6c 20 72 65 73 75 6c 74 | 73 20 63 61 6e 20 62 65 |l result|s can be|
|00001330| 20 6f 62 74 61 69 6e 65 | 64 20 62 79 20 65 78 65 | obtaine|d by exe|
|00001340| 63 75 74 69 6e 67 0a 58 | 2e 4c 57 20 77 72 69 74 |cuting.X|.LW writ|
|00001350| 65 72 0a 58 6f 6e 20 74 | 68 65 20 56 41 58 20 61 |er.Xon t|he VAX a|
|00001360| 6e 64 0a 58 2e 4c 57 20 | 72 65 61 64 65 72 0a 58 |nd.X.LW |reader.X|
|00001370| 6f 6e 20 74 68 65 20 53 | 75 6e 2e 0a 58 54 68 65 |on the S|un..XThe|
|00001380| 73 65 20 72 65 73 75 6c | 74 73 20 6f 63 63 75 72 |se resul|ts occur|
|00001390| 20 62 65 63 61 75 73 65 | 20 74 68 65 20 62 79 74 | because| the byt|
|000013a0| 65 20 6f 72 64 65 72 69 | 6e 67 0a 58 6f 66 20 6c |e orderi|ng.Xof l|
|000013b0| 6f 6e 67 20 69 6e 74 65 | 67 65 72 73 20 64 69 66 |ong inte|gers dif|
|000013c0| 66 65 72 73 20 62 65 74 | 77 65 65 6e 20 74 68 65 |fers bet|ween the|
|000013d0| 20 56 41 58 20 61 6e 64 | 20 74 68 65 20 53 75 6e | VAX and| the Sun|
|000013e0| 2c 0a 58 65 76 65 6e 20 | 74 68 6f 75 67 68 20 77 |,.Xeven |though w|
|000013f0| 6f 72 64 20 73 69 7a 65 | 20 69 73 20 74 68 65 20 |ord size| is the |
|00001400| 73 61 6d 65 2e 0a 58 4e | 6f 74 65 20 74 68 61 74 |same..XN|ote that|
|00001410| 20 24 31 36 37 37 37 32 | 31 36 24 20 69 73 20 24 | $167772|16$ is $|
|00001420| 32 20 73 75 70 20 32 34 | 24 20 5c 28 65 6d 0a 58 |2 sup 24|$ \(em.X|
|00001430| 77 68 65 6e 20 66 6f 75 | 72 20 62 79 74 65 73 20 |when fou|r bytes |
|00001440| 61 72 65 20 72 65 76 65 | 72 73 65 64 2c 20 74 68 |are reve|rsed, th|
|00001450| 65 20 31 20 77 69 6e 64 | 73 20 75 70 20 69 6e 20 |e 1 wind|s up in |
|00001460| 74 68 65 20 32 34 74 68 | 20 62 69 74 2e 0a 58 2e |the 24th| bit..X.|
|00001470| 4c 50 0a 58 57 68 65 6e | 65 76 65 72 20 64 61 74 |LP.XWhen|ever dat|
|00001480| 61 20 69 73 20 73 68 61 | 72 65 64 20 62 79 20 74 |a is sha|red by t|
|00001490| 77 6f 20 6f 72 20 6d 6f | 72 65 20 6d 61 63 68 69 |wo or mo|re machi|
|000014a0| 6e 65 20 74 79 70 65 73 | 2c 0a 58 74 68 65 72 65 |ne types|,.Xthere|
|000014b0| 20 69 73 20 61 20 6e 65 | 65 64 20 66 6f 72 20 70 | is a ne|ed for p|
|000014c0| 6f 72 74 61 62 6c 65 20 | 64 61 74 61 2e 0a 58 50 |ortable |data..XP|
|000014d0| 72 6f 67 72 61 6d 73 20 | 63 61 6e 20 62 65 20 6d |rograms |can be m|
|000014e0| 61 64 65 20 64 61 74 61 | 2d 70 6f 72 74 61 62 6c |ade data|-portabl|
|000014f0| 65 20 62 79 20 72 65 70 | 6c 61 63 69 6e 67 20 74 |e by rep|lacing t|
|00001500| 68 65 0a 58 2e 4c 57 20 | 72 65 61 64 28 29 0a 58 |he.X.LW |read().X|
|00001510| 61 6e 64 0a 58 2e 4c 57 | 20 77 72 69 74 65 28 29 |and.X.LW| write()|
|00001520| 0a 58 63 61 6c 6c 73 20 | 77 69 74 68 20 63 61 6c |.Xcalls |with cal|
|00001530| 6c 73 20 74 6f 20 61 6e | 20 58 44 52 20 6c 69 62 |ls to an| XDR lib|
|00001540| 72 61 72 79 20 72 6f 75 | 74 69 6e 65 0a 58 2e 4c |rary rou|tine.X.L|
|00001550| 57 20 78 64 72 5f 6c 6f | 6e 67 28 29 20 2c 0a 58 |W xdr_lo|ng() ,.X|
|00001560| 61 20 66 69 6c 74 65 72 | 20 74 68 61 74 20 6b 6e |a filter| that kn|
|00001570| 6f 77 73 20 74 68 65 20 | 73 74 61 6e 64 61 72 64 |ows the |standard|
|00001580| 20 72 65 70 72 65 73 65 | 6e 74 61 74 69 6f 6e 0a | represe|ntation.|
|00001590| 58 6f 66 20 61 20 6c 6f | 6e 67 20 69 6e 74 65 67 |Xof a lo|ng integ|
|000015a0| 65 72 20 69 6e 20 69 74 | 73 20 65 78 74 65 72 6e |er in it|s extern|
|000015b0| 61 6c 20 66 6f 72 6d 2e | 0a 58 48 65 72 65 20 61 |al form.|.XHere a|
|000015c0| 72 65 20 74 68 65 20 72 | 65 76 69 73 65 64 20 76 |re the r|evised v|
|000015d0| 65 72 73 69 6f 6e 73 20 | 6f 66 0a 58 2e 4c 57 20 |ersions |of.X.LW |
|000015e0| 77 72 69 74 65 72 20 3a | 0a 58 2e 4c 53 0a 58 23 |writer :|.X.LS.X#|
|000015f0| 69 6e 63 6c 75 64 65 20 | 3c 73 74 64 69 6f 2e 68 |include |<stdio.h|
|00001600| 3e 0a 58 23 69 6e 63 6c | 75 64 65 20 3c 72 70 63 |>.X#incl|ude <rpc|
|00001610| 2f 72 70 63 2e 68 3e 09 | 2f 2a 20 78 64 72 20 69 |/rpc.h>.|/* xdr i|
|00001620| 73 20 61 20 73 75 62 2d | 6c 69 62 72 61 72 79 20 |s a sub-|library |
|00001630| 6f 66 20 72 70 63 20 2a | 2f 0a 58 2e 73 70 2e 35 |of rpc *|/.X.sp.5|
|00001640| 0a 58 6d 61 69 6e 28 29 | 09 09 2f 2a 20 77 72 69 |.Xmain()|../* wri|
|00001650| 74 65 72 2e 63 20 2a 2f | 0a 58 7b 0a 58 09 58 44 |ter.c */|.X{.X.XD|
|00001660| 52 20 78 64 72 73 3b 0a | 58 09 6c 6f 6e 67 20 69 |R xdrs;.|X.long i|
|00001670| 3b 0a 58 2e 73 70 2e 35 | 0a 58 09 78 64 72 73 74 |;.X.sp.5|.X.xdrst|
|00001680| 64 69 6f 5f 63 72 65 61 | 74 65 28 26 78 64 72 73 |dio_crea|te(&xdrs|
|00001690| 2c 20 73 74 64 6f 75 74 | 2c 20 58 44 52 5f 45 4e |, stdout|, XDR_EN|
|000016a0| 43 4f 44 45 29 3b 0a 58 | 09 66 6f 72 20 28 69 20 |CODE);.X|.for (i |
|000016b0| 3d 20 30 3b 20 69 20 3c | 20 38 3b 20 69 2b 2b 29 |= 0; i <| 8; i++)|
|000016c0| 20 7b 0a 58 09 09 69 66 | 20 28 21 78 64 72 5f 6c | {.X..if| (!xdr_l|
|000016d0| 6f 6e 67 28 26 78 64 72 | 73 2c 20 26 69 29 29 20 |ong(&xdr|s, &i)) |
|000016e0| 7b 0a 58 09 09 09 66 70 | 72 69 6e 74 66 28 73 74 |{.X...fp|rintf(st|
|000016f0| 64 65 72 72 2c 20 22 66 | 61 69 6c 65 64 21 5c 65 |derr, "f|ailed!\e|
|00001700| 6e 22 29 3b 0a 58 09 09 | 09 65 78 69 74 28 31 29 |n");.X..|.exit(1)|
|00001710| 3b 0a 58 09 09 7d 0a 58 | 09 7d 0a 58 7d 0a 58 2e |;.X..}.X|.}.X}.X.|
|00001720| 4c 66 0a 58 61 6e 64 0a | 58 2e 4c 57 20 72 65 61 |Lf.Xand.|X.LW rea|
|00001730| 64 65 72 20 3a 0a 58 2e | 4c 53 0a 58 23 69 6e 63 |der :.X.|LS.X#inc|
|00001740| 6c 75 64 65 20 3c 73 74 | 64 69 6f 2e 68 3e 0a 58 |lude <st|dio.h>.X|
|00001750| 23 69 6e 63 6c 75 64 65 | 20 3c 72 70 63 2f 72 70 |#include| <rpc/rp|
|00001760| 63 2e 68 3e 09 2f 2a 20 | 78 64 72 20 69 73 20 61 |c.h>./* |xdr is a|
|00001770| 20 73 75 62 2d 6c 69 62 | 72 61 72 79 20 6f 66 20 | sub-lib|rary of |
|00001780| 72 70 63 20 2a 2f 0a 58 | 2e 73 70 2e 35 0a 58 6d |rpc */.X|.sp.5.Xm|
|00001790| 61 69 6e 28 29 09 09 2f | 2a 20 72 65 61 64 65 72 |ain()../|* reader|
|000017a0| 2e 63 20 2a 2f 0a 58 7b | 0a 58 09 58 44 52 20 78 |.c */.X{|.X.XDR x|
|000017b0| 64 72 73 3b 0a 58 09 6c | 6f 6e 67 20 69 2c 20 6a |drs;.X.l|ong i, j|
|000017c0| 3b 0a 58 2e 73 70 2e 35 | 0a 58 09 78 64 72 73 74 |;.X.sp.5|.X.xdrst|
|000017d0| 64 69 6f 5f 63 72 65 61 | 74 65 28 26 78 64 72 73 |dio_crea|te(&xdrs|
|000017e0| 2c 20 73 74 64 69 6e 2c | 20 58 44 52 5f 44 45 43 |, stdin,| XDR_DEC|
|000017f0| 4f 44 45 29 3b 0a 58 09 | 66 6f 72 20 28 6a 20 3d |ODE);.X.|for (j =|
|00001800| 20 30 3b 20 6a 20 3c 20 | 38 3b 20 6a 2b 2b 29 20 | 0; j < |8; j++) |
|00001810| 7b 0a 58 09 09 69 66 20 | 28 21 78 64 72 5f 6c 6f |{.X..if |(!xdr_lo|
|00001820| 6e 67 28 26 78 64 72 73 | 2c 20 26 69 29 29 20 7b |ng(&xdrs|, &i)) {|
|00001830| 0a 58 09 09 09 66 70 72 | 69 6e 74 66 28 73 74 64 |.X...fpr|intf(std|
|00001840| 65 72 72 2c 20 22 66 61 | 69 6c 65 64 21 5c 65 6e |err, "fa|iled!\en|
|00001850| 22 29 3b 0a 58 09 09 09 | 65 78 69 74 28 31 29 3b |");.X...|exit(1);|
|00001860| 0a 58 09 09 7d 0a 58 09 | 09 70 72 69 6e 74 66 28 |.X..}.X.|.printf(|
|00001870| 22 25 6c 64 20 22 2c 20 | 69 29 3b 0a 58 09 7d 0a |"%ld ", |i);.X.}.|
|00001880| 58 09 70 72 69 6e 74 66 | 28 22 5c 65 6e 22 29 3b |X.printf|("\en");|
|00001890| 0a 58 7d 0a 58 2e 4c 66 | 0a 58 54 68 65 20 6e 65 |.X}.X.Lf|.XThe ne|
|000018a0| 77 20 70 72 6f 67 72 61 | 6d 73 20 77 65 72 65 20 |w progra|ms were |
|000018b0| 65 78 65 63 75 74 65 64 | 20 6f 6e 20 61 20 53 75 |executed| on a Su|
|000018c0| 6e 2c 0a 58 6f 6e 20 61 | 20 56 41 58 2c 20 61 6e |n,.Xon a| VAX, an|
|000018d0| 64 20 66 72 6f 6d 20 61 | 20 53 75 6e 20 74 6f 20 |d from a| Sun to |
|000018e0| 61 20 56 41 58 3b 0a 58 | 74 68 65 20 72 65 73 75 |a VAX;.X|the resu|
|000018f0| 6c 74 73 20 61 72 65 20 | 73 68 6f 77 6e 20 62 65 |lts are |shown be|
|00001900| 6c 6f 77 2e 0a 58 2e 4c | 53 0a 58 73 75 6e 25 20 |low..X.L|S.Xsun% |
|00001910| 77 72 69 74 65 72 20 7c | 20 72 65 61 64 65 72 0a |writer || reader.|
|00001920| 58 30 20 31 20 32 20 33 | 20 34 20 35 20 36 20 37 |X0 1 2 3| 4 5 6 7|
|00001930| 0a 58 73 75 6e 25 0a 58 | 2e 4c 66 0a 58 2e 4c 53 |.Xsun%.X|.Lf.X.LS|
|00001940| 0a 58 76 61 78 25 20 77 | 72 69 74 65 72 20 7c 20 |.Xvax% w|riter | |
|00001950| 72 65 61 64 65 72 0a 58 | 30 20 31 20 32 20 33 20 |reader.X|0 1 2 3 |
|00001960| 34 20 35 20 36 20 37 0a | 58 76 61 78 25 0a 58 2e |4 5 6 7.|Xvax%.X.|
|00001970| 4c 66 0a 58 2e 4c 53 0a | 58 73 75 6e 25 20 77 72 |Lf.X.LS.|Xsun% wr|
|00001980| 69 74 65 72 20 7c 20 72 | 73 68 20 76 61 78 20 72 |iter | r|sh vax r|
|00001990| 65 61 64 65 72 0a 58 30 | 20 31 20 32 20 33 20 34 |eader.X0| 1 2 3 4|
|000019a0| 20 35 20 36 20 37 0a 58 | 73 75 6e 25 0a 58 2e 4c | 5 6 7.X|sun%.X.L|
|000019b0| 66 0a 58 44 65 61 6c 69 | 6e 67 20 77 69 74 68 20 |f.XDeali|ng with |
|000019c0| 69 6e 74 65 67 65 72 73 | 20 69 73 20 6a 75 73 74 |integers| is just|
|000019d0| 20 74 68 65 20 74 69 70 | 20 6f 66 20 74 68 65 20 | the tip| of the |
|000019e0| 70 6f 72 74 61 62 6c 65 | 2d 64 61 74 61 20 69 63 |portable|-data ic|
|000019f0| 65 62 65 72 67 2e 0a 58 | 41 72 62 69 74 72 61 72 |eberg..X|Arbitrar|
|00001a00| 79 20 64 61 74 61 20 73 | 74 72 75 63 74 75 72 65 |y data s|tructure|
|00001a10| 73 20 70 72 65 73 65 6e | 74 20 70 6f 72 74 61 62 |s presen|t portab|
|00001a20| 69 6c 69 74 79 20 70 72 | 6f 62 6c 65 6d 73 2c 0a |ility pr|oblems,.|
|00001a30| 58 70 61 72 74 69 63 75 | 6c 61 72 6c 79 20 77 69 |Xparticu|larly wi|
|00001a40| 74 68 20 72 65 73 70 65 | 63 74 20 74 6f 20 61 6c |th respe|ct to al|
|00001a50| 69 67 6e 6d 65 6e 74 20 | 61 6e 64 20 70 6f 69 6e |ignment |and poin|
|00001a60| 74 65 72 73 2e 0a 58 41 | 6c 69 67 6e 6d 65 6e 74 |ters..XA|lignment|
|00001a70| 20 6f 6e 20 77 6f 72 64 | 20 62 6f 75 6e 64 61 72 | on word| boundar|
|00001a80| 69 65 73 20 6d 61 79 20 | 63 61 75 73 65 20 74 68 |ies may |cause th|
|00001a90| 65 0a 58 73 69 7a 65 20 | 6f 66 20 61 20 73 74 72 |e.Xsize |of a str|
|00001aa0| 75 63 74 75 72 65 20 74 | 6f 20 76 61 72 79 20 66 |ucture t|o vary f|
|00001ab0| 72 6f 6d 20 6d 61 63 68 | 69 6e 65 20 74 6f 20 6d |rom mach|ine to m|
|00001ac0| 61 63 68 69 6e 65 2e 0a | 58 50 6f 69 6e 74 65 72 |achine..|XPointer|
|00001ad0| 73 20 61 72 65 20 63 6f | 6e 76 65 6e 69 65 6e 74 |s are co|nvenient|
|00001ae0| 20 74 6f 20 75 73 65 2c | 0a 58 62 75 74 20 68 61 | to use,|.Xbut ha|
|00001af0| 76 65 20 6e 6f 20 6d 65 | 61 6e 69 6e 67 20 6f 75 |ve no me|aning ou|
|00001b00| 74 73 69 64 65 20 74 68 | 65 20 6d 61 63 68 69 6e |tside th|e machin|
|00001b10| 65 20 77 68 65 72 65 20 | 74 68 65 79 20 61 72 65 |e where |they are|
|00001b20| 20 64 65 66 69 6e 65 64 | 2e 0a 58 2e 4e 48 20 32 | defined|..X.NH 2|
|00001b30| 0a 58 54 68 65 20 58 44 | 52 20 4c 69 62 72 61 72 |.XThe XD|R Librar|
|00001b40| 79 0a 58 2e 4c 50 0a 58 | 54 68 65 20 58 44 52 20 |y.X.LP.X|The XDR |
|00001b50| 6c 69 62 72 61 72 79 20 | 73 6f 6c 76 65 73 20 64 |library |solves d|
|00001b60| 61 74 61 20 70 6f 72 74 | 61 62 69 6c 69 74 79 20 |ata port|ability |
|00001b70| 70 72 6f 62 6c 65 6d 73 | 2e 0a 58 49 74 20 61 6c |problems|..XIt al|
|00001b80| 6c 6f 77 73 20 79 6f 75 | 20 74 6f 20 77 72 69 74 |lows you| to writ|
|00001b90| 65 20 61 6e 64 20 72 65 | 61 64 20 61 72 62 69 74 |e and re|ad arbit|
|00001ba0| 72 61 72 79 20 43 20 63 | 6f 6e 73 74 72 75 63 74 |rary C c|onstruct|
|00001bb0| 73 0a 58 69 6e 20 61 20 | 63 6f 6e 73 69 73 74 65 |s.Xin a |consiste|
|00001bc0| 6e 74 2c 20 73 70 65 63 | 69 66 69 65 64 2c 20 77 |nt, spec|ified, w|
|00001bd0| 65 6c 6c 2d 64 6f 63 75 | 6d 65 6e 74 65 64 20 6d |ell-docu|mented m|
|00001be0| 61 6e 6e 65 72 2e 0a 58 | 54 68 75 73 2c 20 69 74 |anner..X|Thus, it|
|00001bf0| 20 6d 61 6b 65 73 20 73 | 65 6e 73 65 20 74 6f 20 | makes s|ense to |
|00001c00| 75 73 65 20 74 68 65 20 | 6c 69 62 72 61 72 79 20 |use the |library |
|00001c10| 65 76 65 6e 20 77 68 65 | 6e 20 74 68 65 20 64 61 |even whe|n the da|
|00001c20| 74 61 0a 58 69 73 20 6e | 6f 74 20 73 68 61 72 65 |ta.Xis n|ot share|
|00001c30| 64 20 61 6d 6f 6e 67 20 | 6d 61 63 68 69 6e 65 73 |d among |machines|
|00001c40| 20 6f 6e 20 61 20 6e 65 | 74 77 6f 72 6b 2e 0a 58 | on a ne|twork..X|
|00001c50| 2e 4c 50 0a 58 54 68 65 | 20 58 44 52 20 6c 69 62 |.LP.XThe| XDR lib|
|00001c60| 72 61 72 79 20 68 61 73 | 20 66 69 6c 74 65 72 20 |rary has| filter |
|00001c70| 72 6f 75 74 69 6e 65 73 | 20 66 6f 72 0a 58 73 74 |routines| for.Xst|
|00001c80| 72 69 6e 67 73 20 28 6e | 75 6c 6c 2d 74 65 72 6d |rings (n|ull-term|
|00001c90| 69 6e 61 74 65 64 20 61 | 72 72 61 79 73 20 6f 66 |inated a|rrays of|
|00001ca0| 20 62 79 74 65 73 29 2c | 0a 58 73 74 72 75 63 74 | bytes),|.Xstruct|
|00001cb0| 75 72 65 73 2c 20 75 6e | 69 6f 6e 73 2c 20 61 6e |ures, un|ions, an|
|00001cc0| 64 20 61 72 72 61 79 73 | 2c 20 74 6f 20 6e 61 6d |d arrays|, to nam|
|00001cd0| 65 20 61 20 66 65 77 2e | 0a 58 55 73 69 6e 67 20 |e a few.|.XUsing |
|00001ce0| 6d 6f 72 65 20 70 72 69 | 6d 69 74 69 76 65 20 72 |more pri|mitive r|
|00001cf0| 6f 75 74 69 6e 65 73 2c | 0a 58 79 6f 75 20 63 61 |outines,|.Xyou ca|
|00001d00| 6e 20 77 72 69 74 65 20 | 79 6f 75 72 20 6f 77 6e |n write |your own|
|00001d10| 20 73 70 65 63 69 66 69 | 63 20 58 44 52 20 72 6f | specifi|c XDR ro|
|00001d20| 75 74 69 6e 65 73 0a 58 | 74 6f 20 64 65 73 63 72 |utines.X|to descr|
|00001d30| 69 62 65 20 61 72 62 69 | 74 72 61 72 79 20 64 61 |ibe arbi|trary da|
|00001d40| 74 61 20 73 74 72 75 63 | 74 75 72 65 73 2c 0a 58 |ta struc|tures,.X|
|00001d50| 69 6e 63 6c 75 64 69 6e | 67 20 65 6c 65 6d 65 6e |includin|g elemen|
|00001d60| 74 73 20 6f 66 20 61 72 | 72 61 79 73 2c 20 61 72 |ts of ar|rays, ar|
|00001d70| 6d 73 20 6f 66 20 75 6e | 69 6f 6e 73 2c 0a 58 6f |ms of un|ions,.Xo|
|00001d80| 72 20 6f 62 6a 65 63 74 | 73 20 70 6f 69 6e 74 65 |r object|s pointe|
|00001d90| 64 20 61 74 20 66 72 6f | 6d 20 6f 74 68 65 72 20 |d at fro|m other |
|00001da0| 73 74 72 75 63 74 75 72 | 65 73 2e 0a 58 54 68 65 |structur|es..XThe|
|00001db0| 20 73 74 72 75 63 74 75 | 72 65 73 20 74 68 65 6d | structu|res them|
|00001dc0| 73 65 6c 76 65 73 20 6d | 61 79 20 63 6f 6e 74 61 |selves m|ay conta|
|00001dd0| 69 6e 20 61 72 72 61 79 | 73 20 6f 66 20 61 72 62 |in array|s of arb|
|00001de0| 69 74 72 61 72 79 20 65 | 6c 65 6d 65 6e 74 73 2c |itrary e|lements,|
|00001df0| 0a 58 6f 72 20 70 6f 69 | 6e 74 65 72 73 20 74 6f |.Xor poi|nters to|
|00001e00| 20 6f 74 68 65 72 20 73 | 74 72 75 63 74 75 72 65 | other s|tructure|
|00001e10| 73 2e 0a 58 2e 4c 50 0a | 58 4c 65 74 27 73 20 65 |s..X.LP.|XLet's e|
|00001e20| 78 61 6d 69 6e 65 20 74 | 68 65 20 74 77 6f 20 70 |xamine t|he two p|
|00001e30| 72 6f 67 72 61 6d 73 20 | 6d 6f 72 65 20 63 6c 6f |rograms |more clo|
|00001e40| 73 65 6c 79 2e 0a 58 54 | 68 65 72 65 20 69 73 20 |sely..XT|here is |
|00001e50| 61 20 66 61 6d 69 6c 79 | 20 6f 66 20 58 44 52 20 |a family| of XDR |
|00001e60| 73 74 72 65 61 6d 20 63 | 72 65 61 74 69 6f 6e 20 |stream c|reation |
|00001e70| 72 6f 75 74 69 6e 65 73 | 0a 58 69 6e 20 77 68 69 |routines|.Xin whi|
|00001e80| 63 68 20 65 61 63 68 20 | 6d 65 6d 62 65 72 20 74 |ch each |member t|
|00001e90| 72 65 61 74 73 20 74 68 | 65 20 73 74 72 65 61 6d |reats th|e stream|
|00001ea0| 20 6f 66 20 62 69 74 73 | 20 64 69 66 66 65 72 65 | of bits| differe|
|00001eb0| 6e 74 6c 79 2e 0a 58 49 | 6e 20 6f 75 72 20 65 78 |ntly..XI|n our ex|
|00001ec0| 61 6d 70 6c 65 2c 20 64 | 61 74 61 20 69 73 20 6d |ample, d|ata is m|
|00001ed0| 61 6e 69 70 75 6c 61 74 | 65 64 20 75 73 69 6e 67 |anipulat|ed using|
|00001ee0| 20 73 74 61 6e 64 61 72 | 64 20 49 2f 4f 20 72 6f | standar|d I/O ro|
|00001ef0| 75 74 69 6e 65 73 2c 0a | 58 73 6f 20 77 65 20 75 |utines,.|Xso we u|
|00001f00| 73 65 0a 58 2e 4c 57 20 | 78 64 72 73 74 64 69 6f |se.X.LW |xdrstdio|
|00001f10| 5f 63 72 65 61 74 65 28 | 29 20 2e 0a 58 54 68 65 |_create(|) ..XThe|
|00001f20| 20 70 61 72 61 6d 65 74 | 65 72 73 20 74 6f 20 58 | paramet|ers to X|
|00001f30| 44 52 20 73 74 72 65 61 | 6d 20 63 72 65 61 74 69 |DR strea|m creati|
|00001f40| 6f 6e 20 72 6f 75 74 69 | 6e 65 73 0a 58 76 61 72 |on routi|nes.Xvar|
|00001f50| 79 20 61 63 63 6f 72 64 | 69 6e 67 20 74 6f 20 74 |y accord|ing to t|
|00001f60| 68 65 69 72 20 66 75 6e | 63 74 69 6f 6e 2e 0a 58 |heir fun|ction..X|
|00001f70| 49 6e 20 6f 75 72 20 65 | 78 61 6d 70 6c 65 2c 0a |In our e|xample,.|
|00001f80| 58 2e 4c 57 20 78 64 72 | 73 74 64 69 6f 5f 63 72 |X.LW xdr|stdio_cr|
|00001f90| 65 61 74 65 28 29 0a 58 | 74 61 6b 65 73 20 61 20 |eate().X|takes a |
|00001fa0| 70 6f 69 6e 74 65 72 20 | 74 6f 20 61 6e 20 58 44 |pointer |to an XD|
|00001fb0| 52 20 73 74 72 75 63 74 | 75 72 65 20 74 68 61 74 |R struct|ure that|
|00001fc0| 20 69 74 20 69 6e 69 74 | 69 61 6c 69 7a 65 73 2c | it init|ializes,|
|00001fd0| 0a 58 61 20 70 6f 69 6e | 74 65 72 20 74 6f 20 61 |.Xa poin|ter to a|
|00001fe0| 0a 58 2e 4c 57 20 46 49 | 4c 45 0a 58 74 68 61 74 |.X.LW FI|LE.Xthat|
|00001ff0| 20 74 68 65 20 69 6e 70 | 75 74 20 6f 72 20 6f 75 | the inp|ut or ou|
|00002000| 74 70 75 74 20 69 73 20 | 70 65 72 66 6f 72 6d 65 |tput is |performe|
|00002010| 64 20 6f 6e 2c 20 61 6e | 64 20 74 68 65 20 6f 70 |d on, an|d the op|
|00002020| 65 72 61 74 69 6f 6e 2e | 0a 58 54 68 65 20 6f 70 |eration.|.XThe op|
|00002030| 65 72 61 74 69 6f 6e 20 | 6d 61 79 20 62 65 0a 58 |eration |may be.X|
|00002040| 2e 4c 57 20 58 44 52 5f | 45 4e 43 4f 44 45 0a 58 |.LW XDR_|ENCODE.X|
|00002050| 66 6f 72 20 73 65 72 69 | 61 6c 69 7a 69 6e 67 20 |for seri|alizing |
|00002060| 69 6e 20 74 68 65 0a 58 | 2e 4c 57 20 77 72 69 74 |in the.X|.LW writ|
|00002070| 65 72 0a 58 70 72 6f 67 | 72 61 6d 2c 20 6f 72 0a |er.Xprog|ram, or.|
|00002080| 58 2e 4c 57 20 58 44 52 | 5f 44 45 43 4f 44 45 0a |X.LW XDR|_DECODE.|
|00002090| 58 66 6f 72 20 64 65 73 | 65 72 69 61 6c 69 7a 69 |Xfor des|erializi|
|000020a0| 6e 67 20 69 6e 20 74 68 | 65 0a 58 2e 4c 57 20 72 |ng in th|e.X.LW r|
|000020b0| 65 61 64 65 72 0a 58 70 | 72 6f 67 72 61 6d 2e 0a |eader.Xp|rogram..|
|000020c0| 58 2e 4c 50 0a 58 4e 6f | 74 65 3a 20 52 50 43 20 |X.LP.XNo|te: RPC |
|000020d0| 63 6c 69 65 6e 74 73 20 | 6e 65 76 65 72 20 6e 65 |clients |never ne|
|000020e0| 65 64 20 74 6f 20 63 72 | 65 61 74 65 20 58 44 52 |ed to cr|eate XDR|
|000020f0| 20 73 74 72 65 61 6d 73 | 3b 0a 58 74 68 65 20 52 | streams|;.Xthe R|
|00002100| 50 43 20 73 79 73 74 65 | 6d 20 69 74 73 65 6c 66 |PC syste|m itself|
|00002110| 20 63 72 65 61 74 65 73 | 20 74 68 65 73 65 20 73 | creates| these s|
|00002120| 74 72 65 61 6d 73 2c 0a | 58 77 68 69 63 68 20 61 |treams,.|Xwhich a|
|00002130| 72 65 20 74 68 65 6e 20 | 70 61 73 73 65 64 20 74 |re then |passed t|
|00002140| 6f 20 74 68 65 20 63 6c | 69 65 6e 74 73 2e 0a 58 |o the cl|ients..X|
|00002150| 2e 4c 50 0a 58 54 68 65 | 0a 58 2e 4c 57 20 78 64 |.LP.XThe|.X.LW xd|
|00002160| 72 5f 6c 6f 6e 67 28 29 | 0a 58 70 72 69 6d 69 74 |r_long()|.Xprimit|
|00002170| 69 76 65 20 69 73 20 63 | 68 61 72 61 63 74 65 72 |ive is c|haracter|
|00002180| 69 73 74 69 63 20 6f 66 | 20 6d 6f 73 74 20 58 44 |istic of| most XD|
|00002190| 52 20 6c 69 62 72 61 72 | 79 20 0a 58 70 72 69 6d |R librar|y .Xprim|
|000021a0| 69 74 69 76 65 73 20 61 | 6e 64 20 61 6c 6c 20 63 |itives a|nd all c|
|000021b0| 6c 69 65 6e 74 20 58 44 | 52 20 72 6f 75 74 69 6e |lient XD|R routin|
|000021c0| 65 73 2e 0a 58 46 69 72 | 73 74 2c 20 74 68 65 20 |es..XFir|st, the |
|000021d0| 72 6f 75 74 69 6e 65 20 | 72 65 74 75 72 6e 73 0a |routine |returns.|
|000021e0| 58 2e 4c 57 20 46 41 4c | 53 45 0a 58 28 30 29 20 |X.LW FAL|SE.X(0) |
|000021f0| 69 66 20 69 74 20 66 61 | 69 6c 73 2c 20 61 6e 64 |if it fa|ils, and|
|00002200| 0a 58 2e 4c 57 20 54 52 | 55 45 0a 58 28 31 29 20 |.X.LW TR|UE.X(1) |
|00002210| 69 66 20 69 74 20 73 75 | 63 63 65 65 64 73 2e 0a |if it su|cceeds..|
|00002220| 58 53 65 63 6f 6e 64 2c | 20 66 6f 72 20 65 61 63 |XSecond,| for eac|
|00002230| 68 20 64 61 74 61 20 74 | 79 70 65 2c 0a 58 2e 4c |h data t|ype,.X.L|
|00002240| 57 20 78 78 78 20 2c 0a | 58 74 68 65 72 65 20 69 |W xxx ,.|Xthere i|
|00002250| 73 20 61 6e 20 61 73 73 | 6f 63 69 61 74 65 64 20 |s an ass|ociated |
|00002260| 58 44 52 20 72 6f 75 74 | 69 6e 65 20 6f 66 20 74 |XDR rout|ine of t|
|00002270| 68 65 20 66 6f 72 6d 3a | 0a 58 2e 4c 53 0a 58 78 |he form:|.X.LS.Xx|
|00002280| 64 72 5f 78 78 78 28 78 | 64 72 73 2c 20 66 70 29 |dr_xxx(x|drs, fp)|
|00002290| 0a 58 09 58 44 52 20 2a | 78 64 72 73 3b 0a 58 09 |.X.XDR *|xdrs;.X.|
|000022a0| 78 78 78 20 2a 66 70 3b | 0a 58 7b 0a 58 7d 0a 58 |xxx *fp;|.X{.X}.X|
|000022b0| 2e 4c 66 0a 58 49 6e 20 | 6f 75 72 20 63 61 73 65 |.Lf.XIn |our case|
|000022c0| 2c 0a 58 2e 4c 57 20 78 | 78 78 0a 58 69 73 20 6c |,.X.LW x|xx.Xis l|
|000022d0| 6f 6e 67 2c 20 61 6e 64 | 20 74 68 65 20 63 6f 72 |ong, and| the cor|
|000022e0| 72 65 73 70 6f 6e 64 69 | 6e 67 20 58 44 52 20 72 |respondi|ng XDR r|
|000022f0| 6f 75 74 69 6e 65 20 69 | 73 0a 58 61 20 70 72 69 |outine i|s.Xa pri|
|00002300| 6d 69 74 69 76 65 2c 0a | 58 2e 4c 57 20 78 64 72 |mitive,.|X.LW xdr|
|00002310| 5f 6c 6f 6e 67 20 2e 20 | 0a 58 54 68 65 20 63 6c |_long . |.XThe cl|
|00002320| 69 65 6e 74 20 63 6f 75 | 6c 64 20 61 6c 73 6f 20 |ient cou|ld also |
|00002330| 64 65 66 69 6e 65 20 61 | 6e 20 61 72 62 69 74 72 |define a|n arbitr|
|00002340| 61 72 79 20 73 74 72 75 | 63 74 75 72 65 0a 58 2e |ary stru|cture.X.|
|00002350| 4c 57 20 78 78 78 0a 58 | 69 6e 20 77 68 69 63 68 |LW xxx.X|in which|
|00002360| 20 63 61 73 65 20 74 68 | 65 20 63 6c 69 65 6e 74 | case th|e client|
|00002370| 20 77 6f 75 6c 64 20 61 | 6c 73 6f 20 73 75 70 70 | would a|lso supp|
|00002380| 6c 79 20 74 68 65 20 72 | 6f 75 74 69 6e 65 0a 58 |ly the r|outine.X|
|00002390| 2e 4c 57 20 78 64 72 5f | 78 78 78 20 2c 0a 58 64 |.LW xdr_|xxx ,.Xd|
|000023a0| 65 73 63 72 69 62 69 6e | 67 20 65 61 63 68 20 66 |escribin|g each f|
|000023b0| 69 65 6c 64 20 62 79 20 | 63 61 6c 6c 69 6e 67 20 |ield by |calling |
|000023c0| 58 44 52 20 72 6f 75 74 | 69 6e 65 73 0a 58 6f 66 |XDR rout|ines.Xof|
|000023d0| 20 74 68 65 20 61 70 70 | 72 6f 70 72 69 61 74 65 | the app|ropriate|
|000023e0| 20 74 79 70 65 2e 0a 58 | 49 6e 20 61 6c 6c 20 63 | type..X|In all c|
|000023f0| 61 73 65 73 20 74 68 65 | 20 66 69 72 73 74 20 70 |ases the| first p|
|00002400| 61 72 61 6d 65 74 65 72 | 2c 0a 58 2e 4c 57 20 78 |arameter|,.X.LW x|
|00002410| 64 72 73 0a 58 63 61 6e | 20 62 65 20 74 72 65 61 |drs.Xcan| be trea|
|00002420| 74 65 64 20 61 73 20 61 | 6e 20 6f 70 61 71 75 65 |ted as a|n opaque|
|00002430| 20 68 61 6e 64 6c 65 2c | 0a 58 61 6e 64 20 70 61 | handle,|.Xand pa|
|00002440| 73 73 65 64 20 74 6f 20 | 74 68 65 20 70 72 69 6d |ssed to |the prim|
|00002450| 69 74 69 76 65 20 72 6f | 75 74 69 6e 65 73 2e 0a |itive ro|utines..|
|00002460| 58 2e 4c 50 0a 58 58 44 | 52 20 72 6f 75 74 69 6e |X.LP.XXD|R routin|
|00002470| 65 73 20 61 72 65 20 64 | 69 72 65 63 74 69 6f 6e |es are d|irection|
|00002480| 20 69 6e 64 65 70 65 6e | 64 65 6e 74 3b 0a 58 74 | indepen|dent;.Xt|
|00002490| 68 61 74 20 69 73 2c 20 | 74 68 65 20 73 61 6d 65 |hat is, |the same|
|000024a0| 20 72 6f 75 74 69 6e 65 | 73 20 61 72 65 20 63 61 | routine|s are ca|
|000024b0| 6c 6c 65 64 20 74 6f 20 | 73 65 72 69 61 6c 69 7a |lled to |serializ|
|000024c0| 65 20 6f 72 20 64 65 73 | 65 72 69 61 6c 69 7a 65 |e or des|erialize|
|000024d0| 20 64 61 74 61 2e 0a 58 | 54 68 69 73 20 66 65 61 | data..X|This fea|
|000024e0| 74 75 72 65 20 69 73 20 | 63 72 69 74 69 63 61 6c |ture is |critical|
|000024f0| 20 74 6f 20 73 6f 66 74 | 77 61 72 65 20 65 6e 67 | to soft|ware eng|
|00002500| 69 6e 65 65 72 69 6e 67 | 20 6f 66 20 70 6f 72 74 |ineering| of port|
|00002510| 61 62 6c 65 20 64 61 74 | 61 2e 0a 58 54 68 65 20 |able dat|a..XThe |
|00002520| 69 64 65 61 20 69 73 20 | 74 6f 20 63 61 6c 6c 20 |idea is |to call |
|00002530| 74 68 65 20 73 61 6d 65 | 20 72 6f 75 74 69 6e 65 |the same| routine|
|00002540| 20 66 6f 72 20 65 69 74 | 68 65 72 20 6f 70 65 72 | for eit|her oper|
|00002550| 61 74 69 6f 6e 20 5c 28 | 65 6d 0a 58 74 68 69 73 |ation \(|em.Xthis|
|00002560| 20 61 6c 6d 6f 73 74 20 | 67 75 61 72 61 6e 74 65 | almost |guarante|
|00002570| 65 73 20 74 68 61 74 20 | 73 65 72 69 61 6c 69 7a |es that |serializ|
|00002580| 65 64 20 64 61 74 61 20 | 63 61 6e 20 61 6c 73 6f |ed data |can also|
|00002590| 20 62 65 20 64 65 73 65 | 72 69 61 6c 69 7a 65 64 | be dese|rialized|
|000025a0| 2e 0a 58 4f 6e 65 20 72 | 6f 75 74 69 6e 65 20 69 |..XOne r|outine i|
|000025b0| 73 20 75 73 65 64 20 62 | 79 20 62 6f 74 68 20 70 |s used b|y both p|
|000025c0| 72 6f 64 75 63 65 72 20 | 61 6e 64 20 63 6f 6e 73 |roducer |and cons|
|000025d0| 75 6d 65 72 20 6f 66 20 | 6e 65 74 77 6f 72 6b 65 |umer of |networke|
|000025e0| 64 20 64 61 74 61 2e 0a | 58 54 68 69 73 20 69 73 |d data..|XThis is|
|000025f0| 20 69 6d 70 6c 65 6d 65 | 6e 74 65 64 20 62 79 20 | impleme|nted by |
|00002600| 61 6c 77 61 79 73 20 70 | 61 73 73 69 6e 67 20 74 |always p|assing t|
|00002610| 68 65 20 61 64 64 72 65 | 73 73 0a 58 6f 66 20 61 |he addre|ss.Xof a|
|00002620| 6e 20 6f 62 6a 65 63 74 | 20 72 61 74 68 65 72 20 |n object| rather |
|00002630| 74 68 61 6e 20 74 68 65 | 20 6f 62 6a 65 63 74 20 |than the| object |
|00002640| 69 74 73 65 6c 66 20 5c | 28 65 6d 0a 58 6f 6e 6c |itself \|(em.Xonl|
|00002650| 79 20 69 6e 20 74 68 65 | 20 63 61 73 65 20 6f 66 |y in the| case of|
|00002660| 20 64 65 73 65 72 69 61 | 6c 69 7a 61 74 69 6f 6e | deseria|lization|
|00002670| 20 69 73 20 74 68 65 20 | 6f 62 6a 65 63 74 20 6d | is the |object m|
|00002680| 6f 64 69 66 69 65 64 2e | 0a 58 54 68 69 73 20 66 |odified.|.XThis f|
|00002690| 65 61 74 75 72 65 20 69 | 73 20 6e 6f 74 20 73 68 |eature i|s not sh|
|000026a0| 6f 77 6e 20 69 6e 20 6f | 75 72 20 74 72 69 76 69 |own in o|ur trivi|
|000026b0| 61 6c 20 65 78 61 6d 70 | 6c 65 2c 0a 58 62 75 74 |al examp|le,.Xbut|
|000026c0| 20 69 74 73 20 76 61 6c | 75 65 20 62 65 63 6f 6d | its val|ue becom|
|000026d0| 65 73 20 6f 62 76 69 6f | 75 73 20 77 68 65 6e 20 |es obvio|us when |
|000026e0| 6e 6f 6e 74 72 69 76 69 | 61 6c 20 64 61 74 61 20 |nontrivi|al data |
|000026f0| 73 74 72 75 63 74 75 72 | 65 73 0a 58 61 72 65 20 |structur|es.Xare |
|00002700| 70 61 73 73 65 64 20 61 | 6d 6f 6e 67 20 6d 61 63 |passed a|mong mac|
|00002710| 68 69 6e 65 73 2e 0a 58 | 49 66 20 6e 65 65 64 65 |hines..X|If neede|
|00002720| 64 2c 20 79 6f 75 20 63 | 61 6e 20 6f 62 74 61 69 |d, you c|an obtai|
|00002730| 6e 20 74 68 65 20 64 69 | 72 65 63 74 69 6f 6e 20 |n the di|rection |
|00002740| 6f 66 20 74 68 65 20 58 | 44 52 20 6f 70 65 72 61 |of the X|DR opera|
|00002750| 74 69 6f 6e 2e 0a 58 53 | 65 65 20 73 65 63 74 69 |tion..XS|ee secti|
|00002760| 6f 6e 20 33 2e 37 20 66 | 6f 72 20 64 65 74 61 69 |on 3.7 f|or detai|
|00002770| 6c 73 2e 0a 58 2e 4c 50 | 0a 58 4c 65 74 27 73 20 |ls..X.LP|.XLet's |
|00002780| 6c 6f 6f 6b 20 61 74 20 | 61 20 73 6c 69 67 68 74 |look at |a slight|
|00002790| 6c 79 20 6d 6f 72 65 20 | 63 6f 6d 70 6c 69 63 61 |ly more |complica|
|000027a0| 74 65 64 20 65 78 61 6d | 70 6c 65 2e 0a 58 41 73 |ted exam|ple..XAs|
|000027b0| 73 75 6d 65 20 74 68 61 | 74 20 61 20 70 65 72 73 |sume tha|t a pers|
|000027c0| 6f 6e 27 73 20 67 72 6f | 73 73 20 61 73 73 65 74 |on's gro|ss asset|
|000027d0| 73 20 61 6e 64 20 6c 69 | 61 62 69 6c 69 74 69 65 |s and li|abilitie|
|000027e0| 73 0a 58 61 72 65 20 74 | 6f 20 62 65 20 65 78 63 |s.Xare t|o be exc|
|000027f0| 68 61 6e 67 65 64 20 61 | 6d 6f 6e 67 20 70 72 6f |hanged a|mong pro|
|00002800| 63 65 73 73 65 73 2e 0a | 58 41 6c 73 6f 20 61 73 |cesses..|XAlso as|
|00002810| 73 75 6d 65 20 74 68 61 | 74 20 74 68 65 73 65 20 |sume tha|t these |
|00002820| 76 61 6c 75 65 73 20 61 | 72 65 20 69 6d 70 6f 72 |values a|re impor|
|00002830| 74 61 6e 74 20 65 6e 6f | 75 67 68 0a 58 74 6f 20 |tant eno|ugh.Xto |
|00002840| 77 61 72 72 61 6e 74 20 | 74 68 65 69 72 20 6f 77 |warrant |their ow|
|00002850| 6e 20 64 61 74 61 20 74 | 79 70 65 3a 0a 58 2e 4c |n data t|ype:.X.L|
|00002860| 53 0a 58 73 74 72 75 63 | 74 20 67 6e 75 6d 62 65 |S.Xstruc|t gnumbe|
|00002870| 72 73 20 7b 0a 58 09 6c | 6f 6e 67 20 67 5f 61 73 |rs {.X.l|ong g_as|
|00002880| 73 65 74 73 3b 0a 58 09 | 6c 6f 6e 67 20 67 5f 6c |sets;.X.|long g_l|
|00002890| 69 61 62 69 6c 69 74 69 | 65 73 3b 0a 58 7d 3b 0a |iabiliti|es;.X};.|
|000028a0| 58 2e 4c 66 0a 58 54 68 | 65 20 63 6f 72 72 65 73 |X.Lf.XTh|e corres|
|000028b0| 70 6f 6e 64 69 6e 67 20 | 58 44 52 20 72 6f 75 74 |ponding |XDR rout|
|000028c0| 69 6e 65 20 64 65 73 63 | 72 69 62 69 6e 67 20 74 |ine desc|ribing t|
|000028d0| 68 69 73 20 73 74 72 75 | 63 74 75 72 65 20 77 6f |his stru|cture wo|
|000028e0| 75 6c 64 20 62 65 3a 0a | 58 2e 4c 53 0a 58 62 6f |uld be:.|X.LS.Xbo|
|000028f0| 6f 6c 5f 74 20 20 09 09 | 2f 2a 20 54 52 55 45 20 |ol_t  ..|/* TRUE |
|00002900| 69 73 20 73 75 63 63 65 | 73 73 2c 20 46 41 4c 53 |is succe|ss, FALS|
|00002910| 45 20 69 73 20 66 61 69 | 6c 75 72 65 20 2a 2f 0a |E is fai|lure */.|
|00002920| 58 78 64 72 5f 67 6e 75 | 6d 62 65 72 73 28 78 64 |Xxdr_gnu|mbers(xd|
|00002930| 72 73 2c 20 67 70 29 0a | 58 09 58 44 52 20 2a 78 |rs, gp).|X.XDR *x|
|00002940| 64 72 73 3b 0a 58 09 73 | 74 72 75 63 74 20 67 6e |drs;.X.s|truct gn|
|00002950| 75 6d 62 65 72 73 20 2a | 67 70 3b 0a 58 7b 0a 58 |umbers *|gp;.X{.X|
|00002960| 09 69 66 20 28 78 64 72 | 5f 6c 6f 6e 67 28 78 64 |.if (xdr|_long(xd|
|00002970| 72 73 2c 20 26 67 70 2d | 3e 67 5f 61 73 73 65 74 |rs, &gp-|>g_asset|
|00002980| 73 29 20 26 26 0a 58 09 | 20 20 20 20 78 64 72 5f |s) &&.X.|    xdr_|
|00002990| 6c 6f 6e 67 28 78 64 72 | 73 2c 20 26 67 70 2d 3e |long(xdr|s, &gp->|
|000029a0| 67 5f 6c 69 61 62 69 6c | 69 74 69 65 73 29 29 0a |g_liabil|ities)).|
|000029b0| 58 09 09 72 65 74 75 72 | 6e 28 54 52 55 45 29 3b |X..retur|n(TRUE);|
|000029c0| 0a 58 09 72 65 74 75 72 | 6e 28 46 41 4c 53 45 29 |.X.retur|n(FALSE)|
|000029d0| 3b 0a 58 7d 0a 58 2e 4c | 66 0a 58 4e 6f 74 65 20 |;.X}.X.L|f.XNote |
|000029e0| 74 68 61 74 20 74 68 65 | 20 70 61 72 61 6d 65 74 |that the| paramet|
|000029f0| 65 72 0a 58 2e 4c 57 20 | 78 64 72 73 0a 58 69 73 |er.X.LW |xdrs.Xis|
|00002a00| 20 6e 65 76 65 72 20 69 | 6e 73 70 65 63 74 65 64 | never i|nspected|
|00002a10| 20 6f 72 20 6d 6f 64 69 | 66 69 65 64 3b 0a 58 69 | or modi|fied;.Xi|
|00002a20| 74 20 69 73 20 6f 6e 6c | 79 20 70 61 73 73 65 64 |t is onl|y passed|
|00002a30| 20 6f 6e 20 74 6f 20 74 | 68 65 20 73 75 62 63 6f | on to t|he subco|
|00002a40| 6d 70 6f 6e 65 6e 74 20 | 72 6f 75 74 69 6e 65 73 |mponent |routines|
|00002a50| 2e 0a 58 49 74 20 69 73 | 20 69 6d 70 65 72 61 74 |..XIt is| imperat|
|00002a60| 69 76 65 20 74 6f 20 69 | 6e 73 70 65 63 74 20 74 |ive to i|nspect t|
|00002a70| 68 65 20 72 65 74 75 72 | 6e 20 76 61 6c 75 65 20 |he retur|n value |
|00002a80| 6f 66 20 65 61 63 68 20 | 58 44 52 20 72 6f 75 74 |of each |XDR rout|
|00002a90| 69 6e 65 20 63 61 6c 6c | 2c 0a 58 61 6e 64 20 74 |ine call|,.Xand t|
|00002aa0| 6f 20 67 69 76 65 20 75 | 70 20 69 6d 6d 65 64 69 |o give u|p immedi|
|00002ab0| 61 74 65 6c 79 20 61 6e | 64 20 72 65 74 75 72 6e |ately an|d return|
|00002ac0| 0a 58 2e 4c 57 20 46 41 | 4c 53 45 0a 58 69 66 20 |.X.LW FA|LSE.Xif |
|00002ad0| 74 68 65 20 73 75 62 72 | 6f 75 74 69 6e 65 20 66 |the subr|outine f|
|00002ae0| 61 69 6c 73 2e 0a 58 2e | 4c 50 0a 58 54 68 69 73 |ails..X.|LP.XThis|
|00002af0| 20 65 78 61 6d 70 6c 65 | 20 61 6c 73 6f 20 73 68 | example| also sh|
|00002b00| 6f 77 73 20 74 68 61 74 | 20 74 68 65 20 74 79 70 |ows that| the typ|
|00002b10| 65 0a 58 2e 4c 57 20 62 | 6f 6f 6c 5f 74 0a 58 69 |e.X.LW b|ool_t.Xi|
|00002b20| 73 20 64 65 63 6c 61 72 | 65 64 20 61 73 20 61 6e |s declar|ed as an|
|00002b30| 20 69 6e 74 65 67 65 72 | 20 77 68 6f 73 65 20 6f | integer| whose o|
|00002b40| 6e 6c 79 20 76 61 6c 75 | 65 73 20 61 72 65 0a 58 |nly valu|es are.X|
|00002b50| 2e 4c 57 20 54 52 55 45 | 0a 58 28 31 29 20 61 6e |.LW TRUE|.X(1) an|
|00002b60| 64 0a 58 2e 4c 57 20 46 | 41 4c 53 45 0a 58 28 30 |d.X.LW F|ALSE.X(0|
|00002b70| 29 2e 20 20 54 68 69 73 | 20 64 6f 63 75 6d 65 6e |).  This| documen|
|00002b80| 74 20 75 73 65 73 20 74 | 68 65 20 66 6f 6c 6c 6f |t uses t|he follo|
|00002b90| 77 69 6e 67 20 64 65 66 | 69 6e 69 74 69 6f 6e 73 |wing def|initions|
|00002ba0| 3a 0a 58 2e 4c 53 0a 58 | 23 64 65 66 69 6e 65 20 |:.X.LS.X|#define |
|00002bb0| 62 6f 6f 6c 5f 74 09 69 | 6e 74 0a 58 23 64 65 66 |bool_t.i|nt.X#def|
|00002bc0| 69 6e 65 20 54 52 55 45 | 09 31 0a 58 23 64 65 66 |ine TRUE|.1.X#def|
|00002bd0| 69 6e 65 20 46 41 4c 53 | 45 09 30 0a 58 2e 73 70 |ine FALS|E.0.X.sp|
|00002be0| 2e 35 0a 58 23 64 65 66 | 69 6e 65 20 65 6e 75 6d |.5.X#def|ine enum|
|00002bf0| 5f 74 20 69 6e 74 09 2f | 2a 20 65 6e 75 6d 5f 74 |_t int./|* enum_t|
|00002c00| 20 75 73 65 64 20 66 6f | 72 20 67 65 6e 65 72 69 | used fo|r generi|
|00002c10| 63 20 65 6e 75 6d 73 20 | 2a 2f 0a 58 2e 4c 66 0a |c enums |*/.X.Lf.|
|00002c20| 58 2e 4c 50 0a 58 4b 65 | 65 70 69 6e 67 20 74 68 |X.LP.XKe|eping th|
|00002c30| 65 73 65 20 63 6f 6e 76 | 65 6e 74 69 6f 6e 73 20 |ese conv|entions |
|00002c40| 69 6e 20 6d 69 6e 64 2c | 0a 58 2e 4c 57 20 78 64 |in mind,|.X.LW xd|
|00002c50| 72 5f 67 6e 75 6d 62 65 | 72 73 28 29 0a 58 63 61 |r_gnumbe|rs().Xca|
|00002c60| 6e 20 62 65 20 72 65 77 | 72 69 74 74 65 6e 20 61 |n be rew|ritten a|
|00002c70| 73 20 66 6f 6c 6c 6f 77 | 73 3a 0a 58 2e 4c 53 0a |s follow|s:.X.LS.|
|00002c80| 58 78 64 72 5f 67 6e 75 | 6d 62 65 72 73 28 78 64 |Xxdr_gnu|mbers(xd|
|00002c90| 72 73 2c 20 67 70 29 0a | 58 09 58 44 52 20 2a 78 |rs, gp).|X.XDR *x|
|00002ca0| 64 72 73 3b 0a 58 09 73 | 74 72 75 63 74 20 67 6e |drs;.X.s|truct gn|
|00002cb0| 75 6d 62 65 72 73 20 2a | 67 70 3b 0a 58 7b 0a 58 |umbers *|gp;.X{.X|
|00002cc0| 09 72 65 74 75 72 6e 28 | 78 64 72 5f 6c 6f 6e 67 |.return(|xdr_long|
|00002cd0| 28 78 64 72 73 2c 20 26 | 67 70 2d 3e 67 5f 61 73 |(xdrs, &|gp->g_as|
|00002ce0| 73 65 74 73 29 20 26 26 | 0a 58 09 09 78 64 72 5f |sets) &&|.X..xdr_|
|00002cf0| 6c 6f 6e 67 28 78 64 72 | 73 2c 20 26 67 70 2d 3e |long(xdr|s, &gp->|
|00002d00| 67 5f 6c 69 61 62 69 6c | 69 74 69 65 73 29 29 3b |g_liabil|ities));|
|00002d10| 0a 58 7d 0a 58 2e 4c 66 | 0a 58 54 68 69 73 20 64 |.X}.X.Lf|.XThis d|
|00002d20| 6f 63 75 6d 65 6e 74 20 | 75 73 65 73 20 62 6f 74 |ocument |uses bot|
|00002d30| 68 20 63 6f 64 69 6e 67 | 20 73 74 79 6c 65 73 2e |h coding| styles.|
|00002d40| 0a 58 2e 62 70 0a 58 2e | 4e 48 0a 58 58 44 52 20 |.X.bp.X.|NH.XXDR |
|00002d50| 4c 69 62 72 61 72 79 20 | 50 72 69 6d 69 74 69 76 |Library |Primitiv|
|00002d60| 65 73 0a 58 2e 4c 50 0a | 58 54 68 69 73 20 73 65 |es.X.LP.|XThis se|
|00002d70| 63 74 69 6f 6e 20 67 69 | 76 65 73 20 61 20 73 79 |ction gi|ves a sy|
|00002d80| 6e 6f 70 73 69 73 20 6f | 66 20 65 61 63 68 20 58 |nopsis o|f each X|
|00002d90| 44 52 20 70 72 69 6d 69 | 74 69 76 65 2e 0a 58 49 |DR primi|tive..XI|
|00002da0| 74 20 73 74 61 72 74 73 | 20 77 69 74 68 20 62 61 |t starts| with ba|
|00002db0| 73 69 63 20 64 61 74 61 | 20 74 79 70 65 73 20 61 |sic data| types a|
|00002dc0| 6e 64 20 6d 6f 76 65 73 | 20 6f 6e 20 74 6f 20 63 |nd moves| on to c|
|00002dd0| 6f 6e 73 74 72 75 63 74 | 65 64 20 64 61 74 61 20 |onstruct|ed data |
|00002de0| 74 79 70 65 73 2e 0a 58 | 46 69 6e 61 6c 6c 79 2c |types..X|Finally,|
|00002df0| 20 58 44 52 20 75 74 69 | 6c 69 74 69 65 73 20 61 | XDR uti|lities a|
|00002e00| 72 65 20 64 69 73 63 75 | 73 73 65 64 2e 0a 58 54 |re discu|ssed..XT|
|00002e10| 68 65 20 69 6e 74 65 72 | 66 61 63 65 20 74 6f 20 |he inter|face to |
|00002e20| 74 68 65 73 65 20 70 72 | 69 6d 69 74 69 76 65 73 |these pr|imitives|
|00002e30| 0a 58 61 6e 64 20 75 74 | 69 6c 69 74 69 65 73 20 |.Xand ut|ilities |
|00002e40| 69 73 20 64 65 66 69 6e | 65 64 20 69 6e 20 74 68 |is defin|ed in th|
|00002e50| 65 20 69 6e 63 6c 75 64 | 65 20 66 69 6c 65 0a 58 |e includ|e file.X|
|00002e60| 2e 4c 57 20 3c 72 70 63 | 2f 78 64 72 2e 68 3e 20 |.LW <rpc|/xdr.h> |
|00002e70| 2c 0a 58 61 75 74 6f 6d | 61 74 69 63 61 6c 6c 79 |,.Xautom|atically|
|00002e80| 20 69 6e 63 6c 75 64 65 | 64 20 62 79 0a 58 2e 4c | include|d by.X.L|
|00002e90| 57 20 3c 72 70 63 2f 72 | 70 63 2e 68 3e 20 2e 0a |W <rpc/r|pc.h> ..|
|00002ea0| 58 2e 4e 48 20 32 0a 58 | 4e 75 6d 62 65 72 20 46 |X.NH 2.X|Number F|
|00002eb0| 69 6c 74 65 72 73 0a 58 | 2e 4c 50 0a 58 54 68 65 |ilters.X|.LP.XThe|
|00002ec0| 20 58 44 52 20 6c 69 62 | 72 61 72 79 20 70 72 6f | XDR lib|rary pro|
|00002ed0| 76 69 64 65 73 20 70 72 | 69 6d 69 74 69 76 65 73 |vides pr|imitives|
|00002ee0| 20 74 6f 20 74 72 61 6e | 73 6c 61 74 65 20 62 65 | to tran|slate be|
|00002ef0| 74 77 65 65 6e 20 6e 75 | 6d 62 65 72 73 0a 58 61 |tween nu|mbers.Xa|
|00002f00| 6e 64 20 74 68 65 69 72 | 20 63 6f 72 72 65 73 70 |nd their| corresp|
|00002f10| 6f 6e 64 69 6e 67 20 65 | 78 74 65 72 6e 61 6c 20 |onding e|xternal |
|00002f20| 72 65 70 72 65 73 65 6e | 74 61 74 69 6f 6e 73 2e |represen|tations.|
|00002f30| 0a 58 50 72 69 6d 69 74 | 69 76 65 73 20 63 6f 76 |.XPrimit|ives cov|
|00002f40| 65 72 20 74 68 65 20 73 | 65 74 20 6f 66 20 6e 75 |er the s|et of nu|
|00002f50| 6d 62 65 72 73 20 69 6e | 3a 0a 58 2e 45 51 0a 58 |mbers in|:.X.EQ.X|
|00002f60| 5b 73 69 67 6e 65 64 2c | 20 75 6e 73 69 67 6e 65 |[signed,| unsigne|
|00002f70| 64 5d 20 2a 20 5b 73 68 | 6f 72 74 2c 20 69 6e 74 |d] * [sh|ort, int|
|00002f80| 2c 20 6c 6f 6e 67 5d 0a | 58 2e 45 4e 0a 58 53 70 |, long].|X.EN.XSp|
|00002f90| 65 63 69 66 69 63 61 6c | 6c 79 2c 20 74 68 65 20 |ecifical|ly, the |
|00002fa0| 73 69 78 20 70 72 69 6d | 69 74 69 76 65 73 20 61 |six prim|itives a|
|00002fb0| 72 65 3a 0a 58 2e 4c 53 | 0a 58 62 6f 6f 6c 5f 74 |re:.X.LS|.Xbool_t|
|00002fc0| 20 78 64 72 5f 69 6e 74 | 28 78 64 72 73 2c 20 69 | xdr_int|(xdrs, i|
|00002fd0| 70 29 0a 58 09 58 44 52 | 20 2a 78 64 72 73 3b 0a |p).X.XDR| *xdrs;.|
|00002fe0| 58 09 69 6e 74 20 2a 69 | 70 3b 0a 58 2e 73 70 2e |X.int *i|p;.X.sp.|
|00002ff0| 35 0a 58 62 6f 6f 6c 5f | 74 20 78 64 72 5f 75 5f |5.Xbool_|t xdr_u_|
|00003000| 69 6e 74 28 78 64 72 73 | 2c 20 75 70 29 0a 58 09 |int(xdrs|, up).X.|
|00003010| 58 44 52 20 2a 78 64 72 | 73 3b 0a 58 09 75 6e 73 |XDR *xdr|s;.X.uns|
|00003020| 69 67 6e 65 64 20 2a 75 | 70 3b 0a 58 2e 73 70 2e |igned *u|p;.X.sp.|
|00003030| 35 0a 58 62 6f 6f 6c 5f | 74 20 78 64 72 5f 6c 6f |5.Xbool_|t xdr_lo|
|00003040| 6e 67 28 78 64 72 73 2c | 20 6c 69 70 29 0a 58 09 |ng(xdrs,| lip).X.|
|00003050| 58 44 52 20 2a 78 64 72 | 73 3b 0a 58 09 6c 6f 6e |XDR *xdr|s;.X.lon|
|00003060| 67 20 2a 6c 69 70 3b 0a | 58 2e 73 70 2e 35 0a 58 |g *lip;.|X.sp.5.X|
|00003070| 62 6f 6f 6c 5f 74 20 78 | 64 72 5f 75 5f 6c 6f 6e |bool_t x|dr_u_lon|
|00003080| 67 28 78 64 72 73 2c 20 | 6c 75 70 29 0a 58 09 58 |g(xdrs, |lup).X.X|
|00003090| 44 52 20 2a 78 64 72 73 | 3b 0a 58 09 75 5f 6c 6f |DR *xdrs|;.X.u_lo|
|000030a0| 6e 67 20 2a 6c 75 70 3b | 0a 58 2e 73 70 2e 35 0a |ng *lup;|.X.sp.5.|
|000030b0| 58 62 6f 6f 6c 5f 74 20 | 78 64 72 5f 73 68 6f 72 |Xbool_t |xdr_shor|
|000030c0| 74 28 78 64 72 73 2c 20 | 73 69 70 29 0a 58 09 58 |t(xdrs, |sip).X.X|
|000030d0| 44 52 20 2a 78 64 72 73 | 3b 0a 58 09 73 68 6f 72 |DR *xdrs|;.X.shor|
|000030e0| 74 20 2a 73 69 70 3b 0a | 58 2e 73 70 2e 35 0a 58 |t *sip;.|X.sp.5.X|
|000030f0| 62 6f 6f 6c 5f 74 20 78 | 64 72 5f 75 5f 73 68 6f |bool_t x|dr_u_sho|
|00003100| 72 74 28 78 64 72 73 2c | 20 73 75 70 29 0a 58 09 |rt(xdrs,| sup).X.|
|00003110| 58 44 52 20 2a 78 64 72 | 73 3b 0a 58 09 75 5f 73 |XDR *xdr|s;.X.u_s|
|00003120| 68 6f 72 74 20 2a 73 75 | 70 3b 0a 58 2e 4c 66 0a |hort *su|p;.X.Lf.|
|00003130| 58 54 68 65 20 66 69 72 | 73 74 20 70 61 72 61 6d |XThe fir|st param|
|00003140| 65 74 65 72 2c 0a 58 2e | 4c 57 20 78 64 72 73 20 |eter,.X.|LW xdrs |
|00003150| 2c 0a 58 69 73 20 61 6e | 20 58 44 52 20 73 74 72 |,.Xis an| XDR str|
|00003160| 65 61 6d 20 68 61 6e 64 | 6c 65 2e 0a 58 54 68 65 |eam hand|le..XThe|
|00003170| 20 73 65 63 6f 6e 64 20 | 70 61 72 61 6d 65 74 65 | second |paramete|
|00003180| 72 20 69 73 20 74 68 65 | 20 61 64 64 72 65 73 73 |r is the| address|
|00003190| 20 6f 66 20 74 68 65 20 | 6e 75 6d 62 65 72 0a 58 | of the |number.X|
|000031a0| 74 68 61 74 20 70 72 6f | 76 69 64 65 73 20 64 61 |that pro|vides da|
|000031b0| 74 61 20 74 6f 20 74 68 | 65 20 73 74 72 65 61 6d |ta to th|e stream|
|000031c0| 20 6f 72 20 72 65 63 65 | 69 76 65 73 20 64 61 74 | or rece|ives dat|
|000031d0| 61 20 66 72 6f 6d 20 69 | 74 2e 0a 58 41 6c 6c 20 |a from i|t..XAll |
|000031e0| 72 6f 75 74 69 6e 65 73 | 20 72 65 74 75 72 6e 0a |routines| return.|
|000031f0| 58 2e 4c 57 20 54 52 55 | 45 0a 58 69 66 20 74 68 |X.LW TRU|E.Xif th|
|00003200| 65 79 20 63 6f 6d 70 6c | 65 74 65 20 73 75 63 63 |ey compl|ete succ|
|00003210| 65 73 73 66 75 6c 6c 79 | 2c 20 61 6e 64 0a 58 2e |essfully|, and.X.|
|00003220| 4c 57 20 46 41 4c 53 45 | 0a 58 6f 74 68 65 72 77 |LW FALSE|.Xotherw|
|00003230| 69 73 65 2e 0a 58 2e 4e | 48 20 32 0a 58 46 6c 6f |ise..X.N|H 2.XFlo|
|00003240| 61 74 69 6e 67 20 50 6f | 69 6e 74 20 46 69 6c 74 |ating Po|int Filt|
|00003250| 65 72 73 0a 58 2e 4c 50 | 0a 58 54 68 65 20 58 44 |ers.X.LP|.XThe XD|
|00003260| 52 20 6c 69 62 72 61 72 | 79 20 61 6c 73 6f 20 70 |R librar|y also p|
|00003270| 72 6f 76 69 64 65 73 20 | 70 72 69 6d 69 74 69 76 |rovides |primitiv|
|00003280| 65 20 72 6f 75 74 69 6e | 65 73 0a 58 66 6f 72 20 |e routin|es.Xfor |
|00003290| 43 27 73 20 66 6c 6f 61 | 74 69 6e 67 20 70 6f 69 |C's floa|ting poi|
|000032a0| 6e 74 20 74 79 70 65 73 | 3a 0a 58 2e 4c 53 0a 58 |nt types|:.X.LS.X|
|000032b0| 62 6f 6f 6c 5f 74 20 78 | 64 72 5f 66 6c 6f 61 74 |bool_t x|dr_float|
|000032c0| 28 78 64 72 73 2c 20 66 | 70 29 0a 58 09 58 44 52 |(xdrs, f|p).X.XDR|
|000032d0| 20 2a 78 64 72 73 3b 0a | 58 09 66 6c 6f 61 74 20 | *xdrs;.|X.float |
|000032e0| 2a 66 70 3b 0a 58 2e 73 | 70 2e 35 0a 58 62 6f 6f |*fp;.X.s|p.5.Xboo|
|000032f0| 6c 5f 74 20 78 64 72 5f | 64 6f 75 62 6c 65 28 78 |l_t xdr_|double(x|
|00003300| 64 72 73 2c 20 64 70 29 | 0a 58 09 58 44 52 20 2a |drs, dp)|.X.XDR *|
|00003310| 78 64 72 73 3b 0a 58 09 | 64 6f 75 62 6c 65 20 2a |xdrs;.X.|double *|
|00003320| 64 70 3b 0a 58 2e 4c 66 | 0a 58 54 68 65 20 66 69 |dp;.X.Lf|.XThe fi|
|00003330| 72 73 74 20 70 61 72 61 | 6d 65 74 65 72 2c 0a 58 |rst para|meter,.X|
|00003340| 2e 4c 57 20 78 64 72 73 | 0a 58 69 73 20 61 6e 20 |.LW xdrs|.Xis an |
|00003350| 58 44 52 20 73 74 72 65 | 61 6d 20 68 61 6e 64 6c |XDR stre|am handl|
|00003360| 65 2e 0a 58 54 68 65 20 | 73 65 63 6f 6e 64 20 70 |e..XThe |second p|
|00003370| 61 72 61 6d 65 74 65 72 | 20 69 73 20 74 68 65 20 |arameter| is the |
|00003380| 61 64 64 72 65 73 73 0a | 58 6f 66 20 74 68 65 20 |address.|Xof the |
|00003390| 66 6c 6f 61 74 69 6e 67 | 20 70 6f 69 6e 74 20 6e |floating| point n|
|000033a0| 75 6d 62 65 72 20 74 68 | 61 74 20 70 72 6f 76 69 |umber th|at provi|
|000033b0| 64 65 73 20 64 61 74 61 | 20 74 6f 20 74 68 65 20 |des data| to the |
|000033c0| 73 74 72 65 61 6d 0a 58 | 6f 72 20 72 65 63 65 69 |stream.X|or recei|
|000033d0| 76 65 73 20 64 61 74 61 | 20 66 72 6f 6d 20 69 74 |ves data| from it|
|000033e0| 2e 0a 58 41 6c 6c 20 72 | 6f 75 74 69 6e 65 73 20 |..XAll r|outines |
|000033f0| 72 65 74 75 72 6e 0a 58 | 2e 4c 57 20 54 52 55 45 |return.X|.LW TRUE|
|00003400| 0a 58 69 66 20 74 68 65 | 79 20 63 6f 6d 70 6c 65 |.Xif the|y comple|
|00003410| 74 65 20 73 75 63 63 65 | 73 73 66 75 6c 6c 79 2c |te succe|ssfully,|
|00003420| 20 61 6e 64 0a 58 2e 4c | 57 20 46 41 4c 53 45 0a | and.X.L|W FALSE.|
|00003430| 58 6f 74 68 65 72 77 69 | 73 65 2e 0a 58 2e 4c 50 |Xotherwi|se..X.LP|
|00003440| 0a 58 4e 6f 74 65 3a 20 | 53 69 6e 63 65 20 74 68 |.XNote: |Since th|
|00003450| 65 20 6e 75 6d 62 65 72 | 73 20 61 72 65 20 72 65 |e number|s are re|
|00003460| 70 72 65 73 65 6e 74 65 | 64 20 69 6e 20 49 45 45 |presente|d in IEE|
|00003470| 45 20 66 6c 6f 61 74 69 | 6e 67 20 70 6f 69 6e 74 |E floati|ng point|
|00003480| 2c 0a 58 72 6f 75 74 69 | 6e 65 73 20 6d 61 79 20 |,.Xrouti|nes may |
|00003490| 66 61 69 6c 20 77 68 65 | 6e 20 64 65 63 6f 64 69 |fail whe|n decodi|
|000034a0| 6e 67 20 61 20 76 61 6c | 69 64 20 49 45 45 45 20 |ng a val|id IEEE |
|000034b0| 72 65 70 72 65 73 65 6e | 74 61 74 69 6f 6e 0a 58 |represen|tation.X|
|000034c0| 69 6e 74 6f 20 61 20 6d | 61 63 68 69 6e 65 2d 73 |into a m|achine-s|
|000034d0| 70 65 63 69 66 69 63 20 | 72 65 70 72 65 73 65 6e |pecific |represen|
|000034e0| 74 61 74 69 6f 6e 2c 20 | 6f 72 20 76 69 63 65 2d |tation, |or vice-|
|000034f0| 76 65 72 73 61 2e 0a 58 | 2e 4e 48 20 32 0a 58 45 |versa..X|.NH 2.XE|
|00003500| 6e 75 6d 65 72 61 74 69 | 6f 6e 20 46 69 6c 74 65 |numerati|on Filte|
|00003510| 72 73 0a 58 2e 4c 50 0a | 58 54 68 65 20 58 44 52 |rs.X.LP.|XThe XDR|
|00003520| 20 6c 69 62 72 61 72 79 | 20 70 72 6f 76 69 64 65 | library| provide|
|00003530| 73 20 61 20 70 72 69 6d | 69 74 69 76 65 20 66 6f |s a prim|itive fo|
|00003540| 72 20 67 65 6e 65 72 69 | 63 20 65 6e 75 6d 65 72 |r generi|c enumer|
|00003550| 61 74 69 6f 6e 73 2e 0a | 58 54 68 65 20 70 72 69 |ations..|XThe pri|
|00003560| 6d 69 74 69 76 65 20 61 | 73 73 75 6d 65 73 20 74 |mitive a|ssumes t|
|00003570| 68 61 74 20 61 20 43 0a | 58 2e 4c 57 20 65 6e 75 |hat a C.|X.LW enu|
|00003580| 6d 0a 58 68 61 73 20 74 | 68 65 20 73 61 6d 65 20 |m.Xhas t|he same |
|00003590| 72 65 70 72 65 73 65 6e | 74 61 74 69 6f 6e 20 69 |represen|tation i|
|000035a0| 6e 73 69 64 65 20 74 68 | 65 20 6d 61 63 68 69 6e |nside th|e machin|
|000035b0| 65 20 61 73 20 61 20 43 | 20 69 6e 74 65 67 65 72 |e as a C| integer|
|000035c0| 2e 0a 58 54 68 65 20 62 | 6f 6f 6c 65 61 6e 20 74 |..XThe b|oolean t|
|000035d0| 79 70 65 20 69 73 20 61 | 6e 20 69 6d 70 6f 72 74 |ype is a|n import|
|000035e0| 61 6e 74 20 69 6e 73 74 | 61 6e 63 65 20 6f 66 20 |ant inst|ance of |
|000035f0| 74 68 65 0a 58 2e 4c 57 | 20 65 6e 75 6d 20 2e 0a |the.X.LW| enum ..|
|00003600| 58 54 68 65 20 65 78 74 | 65 72 6e 61 6c 20 72 65 |XThe ext|ernal re|
|00003610| 70 72 65 73 65 6e 74 61 | 74 69 6f 6e 20 6f 66 20 |presenta|tion of |
|00003620| 61 20 62 6f 6f 6c 65 61 | 6e 20 69 73 20 61 6c 77 |a boolea|n is alw|
|00003630| 61 79 73 20 6f 6e 65 0a | 58 2e 4c 57 20 54 52 55 |ays one.|X.LW TRU|
|00003640| 45 20 29 20 28 0a 58 6f | 72 20 7a 65 72 6f 0a 58 |E ) (.Xo|r zero.X|
|00003650| 2e 4c 57 20 46 41 4c 53 | 45 20 29 2e 20 28 0a 58 |.LW FALS|E ). (.X|
|00003660| 2e 4c 53 0a 58 23 64 65 | 66 69 6e 65 20 62 6f 6f |.LS.X#de|fine boo|
|00003670| 6c 5f 74 09 69 6e 74 0a | 58 23 64 65 66 69 6e 65 |l_t.int.|X#define|
|00003680| 20 46 41 4c 53 45 09 30 | 0a 58 23 64 65 66 69 6e | FALSE.0|.X#defin|
|00003690| 65 20 54 52 55 45 09 31 | 0a 58 2e 73 70 2e 35 0a |e TRUE.1|.X.sp.5.|
|000036a0| 58 23 64 65 66 69 6e 65 | 20 65 6e 75 6d 5f 74 20 |X#define| enum_t |
|000036b0| 69 6e 74 0a 58 2e 73 70 | 2e 35 0a 58 62 6f 6f 6c |int.X.sp|.5.Xbool|
|000036c0| 5f 74 20 78 64 72 5f 65 | 6e 75 6d 28 78 64 72 73 |_t xdr_e|num(xdrs|
|000036d0| 2c 20 65 70 29 0a 58 09 | 58 44 52 20 2a 78 64 72 |, ep).X.|XDR *xdr|
|000036e0| 73 3b 0a 58 09 65 6e 75 | 6d 5f 74 20 2a 65 70 3b |s;.X.enu|m_t *ep;|
|000036f0| 0a 58 2e 73 70 2e 35 0a | 58 62 6f 6f 6c 5f 74 20 |.X.sp.5.|Xbool_t |
|00003700| 78 64 72 5f 62 6f 6f 6c | 28 78 64 72 73 2c 20 62 |xdr_bool|(xdrs, b|
|00003710| 70 29 0a 58 09 58 44 52 | 20 2a 78 64 72 73 3b 0a |p).X.XDR| *xdrs;.|
|00003720| 58 09 62 6f 6f 6c 5f 74 | 20 2a 62 70 3b 0a 58 2e |X.bool_t| *bp;.X.|
|00003730| 4c 66 0a 58 54 68 65 20 | 73 65 63 6f 6e 64 20 70 |Lf.XThe |second p|
|00003740| 61 72 61 6d 65 74 65 72 | 73 0a 58 2e 4c 57 20 65 |arameter|s.X.LW e|
|00003750| 70 0a 58 61 6e 64 0a 58 | 2e 4c 57 20 62 70 0a 58 |p.Xand.X|.LW bp.X|
|00003760| 61 72 65 20 61 64 64 72 | 65 73 73 65 73 20 6f 66 |are addr|esses of|
|00003770| 20 74 68 65 20 61 73 73 | 6f 63 69 61 74 65 64 20 | the ass|ociated |
|00003780| 74 79 70 65 0a 58 74 68 | 61 74 20 70 72 6f 76 69 |type.Xth|at provi|
|00003790| 64 65 73 20 64 61 74 61 | 20 74 6f 2c 20 6f 72 20 |des data| to, or |
|000037a0| 72 65 63 65 69 76 65 73 | 20 64 61 74 61 20 66 72 |receives| data fr|
|000037b0| 6f 6d 2c 20 74 68 65 20 | 73 74 72 65 61 6d 0a 58 |om, the |stream.X|
|000037c0| 2e 4c 57 20 78 64 72 73 | 20 2e 0a 58 54 68 65 20 |.LW xdrs| ..XThe |
|000037d0| 72 6f 75 74 69 6e 65 73 | 20 72 65 74 75 72 6e 0a |routines| return.|
|000037e0| 58 2e 4c 57 20 54 52 55 | 45 0a 58 69 66 20 74 68 |X.LW TRU|E.Xif th|
|000037f0| 65 79 20 63 6f 6d 70 6c | 65 74 65 20 73 75 63 63 |ey compl|ete succ|
|00003800| 65 73 73 66 75 6c 6c 79 | 2c 20 61 6e 64 0a 58 2e |essfully|, and.X.|
|00003810| 4c 57 20 46 41 4c 53 45 | 0a 58 6f 74 68 65 72 77 |LW FALSE|.Xotherw|
|00003820| 69 73 65 2e 0a 58 2e 4e | 48 20 32 0a 58 4e 6f 20 |ise..X.N|H 2.XNo |
|00003830| 44 61 74 61 0a 58 2e 4c | 50 0a 58 4f 63 63 61 73 |Data.X.L|P.XOccas|
|00003840| 69 6f 6e 61 6c 6c 79 2c | 20 61 6e 20 58 44 52 20 |ionally,| an XDR |
|00003850| 72 6f 75 74 69 6e 65 20 | 6d 75 73 74 20 62 65 20 |routine |must be |
|00003860| 73 75 70 70 6c 69 65 64 | 20 74 6f 20 74 68 65 20 |supplied| to the |
|00003870| 52 50 43 20 73 79 73 74 | 65 6d 2c 0a 58 65 76 65 |RPC syst|em,.Xeve|
|00003880| 6e 20 77 68 65 6e 20 6e | 6f 20 64 61 74 61 20 69 |n when n|o data i|
|00003890| 73 20 70 61 73 73 65 64 | 20 6f 72 20 72 65 71 75 |s passed| or requ|
|000038a0| 69 72 65 64 2e 0a 58 54 | 68 65 20 6c 69 62 72 61 |ired..XT|he libra|
|000038b0| 72 79 20 70 72 6f 76 69 | 64 65 73 20 73 75 63 68 |ry provi|des such|
|000038c0| 20 61 20 72 6f 75 74 69 | 6e 65 3a 0a 58 2e 4c 53 | a routi|ne:.X.LS|
|000038d0| 0a 58 62 6f 6f 6c 5f 74 | 20 78 64 72 5f 76 6f 69 |.Xbool_t| xdr_voi|
|000038e0| 64 28 29 3b 20 20 2f 2a | 20 61 6c 77 61 79 73 20 |d();  /*| always |
|000038f0| 72 65 74 75 72 6e 73 20 | 54 52 55 45 20 2a 2f 0a |returns |TRUE */.|
|00003900| 58 2e 4c 66 0a 58 2e 4e | 48 20 32 0a 58 43 6f 6e |X.Lf.X.N|H 2.XCon|
|00003910| 73 74 72 75 63 74 65 64 | 20 44 61 74 61 20 54 79 |structed| Data Ty|
|00003920| 70 65 20 46 69 6c 74 65 | 72 73 0a 58 2e 4c 50 0a |pe Filte|rs.X.LP.|
|00003930| 58 43 6f 6e 73 74 72 75 | 63 74 65 64 20 6f 72 20 |XConstru|cted or |
|00003940| 63 6f 6d 70 6f 75 6e 64 | 20 64 61 74 61 20 74 79 |compound| data ty|
|00003950| 70 65 20 70 72 69 6d 69 | 74 69 76 65 73 0a 58 72 |pe primi|tives.Xr|
|00003960| 65 71 75 69 72 65 20 6d | 6f 72 65 20 70 61 72 61 |equire m|ore para|
|00003970| 6d 65 74 65 72 73 20 61 | 6e 64 20 70 65 72 66 6f |meters a|nd perfo|
|00003980| 72 6d 20 6d 6f 72 65 20 | 63 6f 6d 70 6c 69 63 61 |rm more |complica|
|00003990| 74 65 64 20 66 75 6e 63 | 74 69 6f 6e 73 0a 58 74 |ted func|tions.Xt|
|000039a0| 68 65 6e 20 74 68 65 20 | 70 72 69 6d 69 74 69 76 |hen the |primitiv|
|000039b0| 65 73 20 64 69 73 63 75 | 73 73 65 64 20 61 62 6f |es discu|ssed abo|
|000039c0| 76 65 2e 0a 58 54 68 69 | 73 20 73 65 63 74 69 6f |ve..XThi|s sectio|
|000039d0| 6e 20 69 6e 63 6c 75 64 | 65 73 20 70 72 69 6d 69 |n includ|es primi|
|000039e0| 74 69 76 65 73 20 66 6f | 72 0a 58 73 74 72 69 6e |tives fo|r.Xstrin|
|000039f0| 67 73 2c 20 61 72 72 61 | 79 73 2c 20 75 6e 69 6f |gs, arra|ys, unio|
|00003a00| 6e 73 2c 20 61 6e 64 20 | 70 6f 69 6e 74 65 72 73 |ns, and |pointers|
|00003a10| 20 74 6f 20 73 74 72 75 | 63 74 75 72 65 73 2e 0a | to stru|ctures..|
|00003a20| 58 2e 4c 50 0a 58 43 6f | 6e 73 74 72 75 63 74 65 |X.LP.XCo|nstructe|
|00003a30| 64 20 64 61 74 61 20 74 | 79 70 65 20 70 72 69 6d |d data t|ype prim|
|00003a40| 69 74 69 76 65 73 20 6d | 61 79 20 75 73 65 20 6d |itives m|ay use m|
|00003a50| 65 6d 6f 72 79 20 6d 61 | 6e 61 67 65 6d 65 6e 74 |emory ma|nagement|
|00003a60| 2e 0a 58 49 6e 20 6d 61 | 6e 79 20 63 61 73 65 73 |..XIn ma|ny cases|
|00003a70| 2c 20 6d 65 6d 6f 72 79 | 20 69 73 20 61 6c 6c 6f |, memory| is allo|
|00003a80| 63 61 74 65 64 20 77 68 | 65 6e 20 64 65 73 65 72 |cated wh|en deser|
|00003a90| 69 61 6c 69 7a 69 6e 67 | 20 64 61 74 61 20 77 69 |ializing| data wi|
|00003aa0| 74 68 0a 58 2e 4c 57 20 | 58 44 52 5f 44 45 43 4f |th.X.LW |XDR_DECO|
|00003ab0| 44 45 20 2e 0a 58 54 68 | 65 72 65 66 6f 72 65 2c |DE ..XTh|erefore,|
|00003ac0| 20 74 68 65 20 58 44 52 | 20 70 61 63 6b 61 67 65 | the XDR| package|
|00003ad0| 20 6d 75 73 74 20 70 72 | 6f 76 69 64 65 20 6d 65 | must pr|ovide me|
|00003ae0| 61 6e 73 20 74 6f 20 64 | 65 61 6c 6c 6f 63 61 74 |ans to d|eallocat|
|00003af0| 65 20 6d 65 6d 6f 72 79 | 2e 0a 58 54 68 69 73 20 |e memory|..XThis |
|00003b00| 69 73 20 64 6f 6e 65 20 | 62 79 20 61 6e 20 58 44 |is done |by an XD|
|00003b10| 52 20 6f 70 65 72 61 74 | 69 6f 6e 2c 0a 58 2e 4c |R operat|ion,.X.L|
|00003b20| 57 20 58 44 52 5f 46 52 | 45 45 20 2e 0a 58 54 6f |W XDR_FR|EE ..XTo|
|00003b30| 20 72 65 76 69 65 77 2c | 20 74 68 65 20 74 68 72 | review,| the thr|
|00003b40| 65 65 20 58 44 52 20 64 | 69 72 65 63 74 69 6f 6e |ee XDR d|irection|
|00003b50| 61 6c 20 6f 70 65 72 61 | 74 69 6f 6e 73 20 61 72 |al opera|tions ar|
|00003b60| 65 0a 58 2e 4c 57 20 58 | 44 52 5f 45 4e 43 4f 44 |e.X.LW X|DR_ENCOD|
|00003b70| 45 20 2c 0a 58 2e 4c 57 | 20 58 44 52 5f 44 45 43 |E ,.X.LW| XDR_DEC|
|00003b80| 4f 44 45 20 2c 0a 58 61 | 6e 64 0a 58 2e 4c 57 20 |ODE ,.Xa|nd.X.LW |
|00003b90| 58 44 52 5f 46 52 45 45 | 20 2e 0a 58 2e 4e 48 20 |XDR_FREE| ..X.NH |
|00003ba0| 33 0a 58 53 74 72 69 6e | 67 73 0a 58 2e 4c 50 0a |3.XStrin|gs.X.LP.|
|00003bb0| 58 49 6e 20 43 2c 20 61 | 20 73 74 72 69 6e 67 20 |XIn C, a| string |
|00003bc0| 69 73 20 64 65 66 69 6e | 65 64 20 61 73 20 61 20 |is defin|ed as a |
|00003bd0| 73 65 71 75 65 6e 63 65 | 20 6f 66 20 62 79 74 65 |sequence| of byte|
|00003be0| 73 0a 58 74 65 72 6d 69 | 6e 61 74 65 64 20 62 79 |s.Xtermi|nated by|
|00003bf0| 20 61 20 6e 75 6c 6c 20 | 62 79 74 65 2c 0a 58 77 | a null |byte,.Xw|
|00003c00| 68 69 63 68 20 69 73 20 | 6e 6f 74 20 63 6f 6e 73 |hich is |not cons|
|00003c10| 69 64 65 72 65 64 20 77 | 68 65 6e 20 63 61 6c 63 |idered w|hen calc|
|00003c20| 75 6c 61 74 69 6e 67 20 | 73 74 72 69 6e 67 20 6c |ulating |string l|
|00003c30| 65 6e 67 74 68 2e 0a 58 | 48 6f 77 65 76 65 72 2c |ength..X|However,|
|00003c40| 20 77 68 65 6e 20 61 20 | 73 74 72 69 6e 67 20 69 | when a |string i|
|00003c50| 73 20 70 61 73 73 65 64 | 20 6f 72 20 6d 61 6e 69 |s passed| or mani|
|00003c60| 70 75 6c 61 74 65 64 2c | 0a 58 61 20 70 6f 69 6e |pulated,|.Xa poin|
|00003c70| 74 65 72 20 74 6f 20 69 | 74 20 69 73 20 65 6d 70 |ter to i|t is emp|
|00003c80| 6c 6f 79 65 64 2e 0a 58 | 54 68 65 72 65 66 6f 72 |loyed..X|Therefor|
|00003c90| 65 2c 20 74 68 65 20 58 | 44 52 20 6c 69 62 72 61 |e, the X|DR libra|
|00003ca0| 72 79 20 64 65 66 69 6e | 65 73 20 61 20 73 74 72 |ry defin|es a str|
|00003cb0| 69 6e 67 20 74 6f 20 62 | 65 20 61 0a 58 2e 4c 57 |ing to b|e a.X.LW|
|00003cc0| 20 22 63 68 61 72 20 2a | 22 20 2c 0a 58 61 6e 64 | "char *|" ,.Xand|
|00003cd0| 20 6e 6f 74 20 61 20 73 | 65 71 75 65 6e 63 65 20 | not a s|equence |
|00003ce0| 6f 66 20 63 68 61 72 61 | 63 74 65 72 73 2e 0a 58 |of chara|cters..X|
|00003cf0| 54 68 65 20 65 78 74 65 | 72 6e 61 6c 20 72 65 70 |The exte|rnal rep|
|00003d00| 72 65 73 65 6e 74 61 74 | 69 6f 6e 20 6f 66 20 61 |resentat|ion of a|
|00003d10| 20 73 74 72 69 6e 67 20 | 69 73 20 64 72 61 73 74 | string |is drast|
|00003d20| 69 63 61 6c 6c 79 20 64 | 69 66 66 65 72 65 6e 74 |ically d|ifferent|
|00003d30| 0a 58 66 72 6f 6d 20 69 | 74 73 20 69 6e 74 65 72 |.Xfrom i|ts inter|
|00003d40| 6e 61 6c 20 72 65 70 72 | 65 73 65 6e 74 61 74 69 |nal repr|esentati|
|00003d50| 6f 6e 2e 0a 58 45 78 74 | 65 72 6e 61 6c 6c 79 2c |on..XExt|ernally,|
|00003d60| 20 73 74 72 69 6e 67 73 | 20 61 72 65 20 72 65 70 | strings| are rep|
|00003d70| 72 65 73 65 6e 74 65 64 | 20 61 73 0a 58 73 65 71 |resented| as.Xseq|
|00003d80| 75 65 6e 63 65 73 20 6f | 66 20 41 53 43 49 49 20 |uences o|f ASCII |
|00003d90| 63 68 61 72 61 63 74 65 | 72 73 2c 0a 58 77 68 69 |characte|rs,.Xwhi|
|00003da0| 6c 65 20 69 6e 74 65 72 | 6e 61 6c 6c 79 2c 20 74 |le inter|nally, t|
|00003db0| 68 65 79 20 61 72 65 20 | 72 65 70 72 65 73 65 6e |hey are |represen|
|00003dc0| 74 65 64 20 77 69 74 68 | 20 63 68 61 72 61 63 74 |ted with| charact|
|00003dd0| 65 72 20 70 6f 69 6e 74 | 65 72 73 2e 0a 58 43 6f |er point|ers..XCo|
|00003de0| 6e 76 65 72 73 69 6f 6e | 20 62 65 74 77 65 65 6e |nversion| between|
|00003df0| 20 74 68 65 20 74 77 6f | 20 72 65 70 72 65 73 65 | the two| represe|
|00003e00| 6e 74 61 74 69 6f 6e 73 | 0a 58 69 73 20 61 63 63 |ntations|.Xis acc|
|00003e10| 6f 6d 70 6c 69 73 68 65 | 64 20 77 69 74 68 20 74 |omplishe|d with t|
|00003e20| 68 65 20 72 6f 75 74 69 | 6e 65 0a 58 2e 4c 57 20 |he routi|ne.X.LW |
|00003e30| 78 64 72 5f 73 74 72 69 | 6e 67 28 29 20 3a 0a 58 |xdr_stri|ng() :.X|
|00003e40| 2e 4c 53 0a 58 62 6f 6f | 6c 5f 74 20 78 64 72 5f |.LS.Xboo|l_t xdr_|
|00003e50| 73 74 72 69 6e 67 28 78 | 64 72 73 2c 20 73 70 2c |string(x|drs, sp,|
|00003e60| 20 6d 61 78 6c 65 6e 67 | 74 68 29 0a 58 09 58 44 | maxleng|th).X.XD|
|00003e70| 52 20 2a 78 64 72 73 3b | 0a 58 09 63 68 61 72 20 |R *xdrs;|.X.char |
|00003e80| 2a 2a 73 70 3b 0a 58 09 | 75 5f 69 6e 74 20 6d 61 |**sp;.X.|u_int ma|
|00003e90| 78 6c 65 6e 67 74 68 3b | 0a 58 2e 4c 66 0a 58 54 |xlength;|.X.Lf.XT|
|00003ea0| 68 65 20 66 69 72 73 74 | 20 70 61 72 61 6d 65 74 |he first| paramet|
|00003eb0| 65 72 0a 58 2e 4c 57 20 | 78 64 72 73 0a 58 69 73 |er.X.LW |xdrs.Xis|
|00003ec0| 20 74 68 65 20 58 44 52 | 20 73 74 72 65 61 6d 20 | the XDR| stream |
|00003ed0| 68 61 6e 64 6c 65 2e 0a | 58 54 68 65 20 73 65 63 |handle..|XThe sec|
|00003ee0| 6f 6e 64 20 70 61 72 61 | 6d 65 74 65 72 0a 58 2e |ond para|meter.X.|
|00003ef0| 4c 57 20 73 70 0a 58 69 | 73 20 61 20 70 6f 69 6e |LW sp.Xi|s a poin|
|00003f00| 74 65 72 20 74 6f 20 61 | 20 73 74 72 69 6e 67 20 |ter to a| string |
|00003f10| 28 74 79 70 65 0a 58 2e | 4c 57 20 22 63 68 61 72 |(type.X.|LW "char|
|00003f20| 20 2a 2a 22 20 29 2e 0a | 58 54 68 65 20 74 68 69 | **" )..|XThe thi|
|00003f30| 72 64 20 70 61 72 61 6d | 65 74 65 72 0a 58 2e 4c |rd param|eter.X.L|
|00003f40| 57 20 6d 61 78 6c 65 6e | 67 74 68 0a 58 73 70 65 |W maxlen|gth.Xspe|
|00003f50| 63 69 66 69 65 73 20 74 | 68 65 20 6d 61 78 69 6d |cifies t|he maxim|
|00003f60| 75 6d 20 6e 75 6d 62 65 | 72 20 6f 66 20 62 79 74 |um numbe|r of byt|
|00003f70| 65 73 20 61 6c 6c 6f 77 | 65 64 20 64 75 72 69 6e |es allow|ed durin|
|00003f80| 67 20 65 6e 63 6f 64 69 | 6e 67 20 6f 72 20 64 65 |g encodi|ng or de|
|00003f90| 63 6f 64 69 6e 67 3b 0a | 58 69 74 73 20 76 61 6c |coding;.|Xits val|
|00003fa0| 75 65 20 69 73 20 75 73 | 75 61 6c 6c 79 20 73 70 |ue is us|ually sp|
|00003fb0| 65 63 69 66 69 65 64 20 | 62 79 20 61 20 70 72 6f |ecified |by a pro|
|00003fc0| 74 6f 63 6f 6c 2e 0a 58 | 46 6f 72 20 65 78 61 6d |tocol..X|For exam|
|00003fd0| 70 6c 65 2c 20 61 20 70 | 72 6f 74 6f 63 6f 6c 20 |ple, a p|rotocol |
|00003fe0| 73 70 65 63 69 66 69 63 | 61 74 69 6f 6e 20 6d 61 |specific|ation ma|
|00003ff0| 79 20 73 61 79 0a 58 74 | 68 61 74 20 61 20 66 69 |y say.Xt|hat a fi|
|00004000| 6c 65 20 6e 61 6d 65 20 | 6d 61 79 20 62 65 20 6e |le name |may be n|
|00004010| 6f 20 6c 6f 6e 67 65 72 | 20 74 68 61 6e 20 32 35 |o longer| than 25|
|00004020| 35 20 63 68 61 72 61 63 | 74 65 72 73 2e 0a 58 54 |5 charac|ters..XT|
|00004030| 68 65 20 72 6f 75 74 69 | 6e 65 20 72 65 74 75 72 |he routi|ne retur|
|00004040| 6e 73 0a 58 2e 4c 57 20 | 46 41 4c 53 45 0a 58 69 |ns.X.LW |FALSE.Xi|
|00004050| 66 20 74 68 65 20 6e 75 | 6d 62 65 72 20 6f 66 20 |f the nu|mber of |
|00004060| 63 68 61 72 61 63 74 65 | 72 73 20 65 78 63 65 65 |characte|rs excee|
|00004070| 64 73 0a 58 2e 4c 57 20 | 6d 61 78 6c 65 6e 67 74 |ds.X.LW |maxlengt|
|00004080| 68 20 2c 0a 58 61 6e 64 | 0a 58 2e 4c 57 20 54 52 |h ,.Xand|.X.LW TR|
|00004090| 55 45 0a 58 69 66 20 69 | 74 20 64 6f 65 73 6e 27 |UE.Xif i|t doesn'|
|000040a0| 74 2e 0a 58 2e 4c 50 0a | 58 54 68 65 20 62 65 68 |t..X.LP.|XThe beh|
|000040b0| 61 76 69 6f 72 20 6f 66 | 0a 58 2e 4c 57 20 78 64 |avior of|.X.LW xd|
|000040c0| 72 5f 73 74 72 69 6e 67 | 28 29 0a 58 69 73 20 73 |r_string|().Xis s|
|000040d0| 69 6d 69 6c 61 72 20 74 | 6f 20 74 68 65 20 62 65 |imilar t|o the be|
|000040e0| 68 61 76 69 6f 72 20 6f | 66 20 6f 74 68 65 72 20 |havior o|f other |
|000040f0| 72 6f 75 74 69 6e 65 73 | 0a 58 64 69 73 63 75 73 |routines|.Xdiscus|
|00004100| 73 65 64 20 69 6e 20 74 | 68 69 73 20 73 65 63 74 |sed in t|his sect|
|00004110| 69 6f 6e 2e 20 20 54 68 | 65 20 64 69 72 65 63 74 |ion.  Th|e direct|
|00004120| 69 6f 6e 0a 58 2e 4c 57 | 20 58 44 52 5f 45 4e 43 |ion.X.LW| XDR_ENC|
|00004130| 4f 44 45 0a 58 69 73 20 | 65 61 73 69 65 73 74 20 |ODE.Xis |easiest |
|00004140| 74 6f 20 75 6e 64 65 72 | 73 74 61 6e 64 2e 20 20 |to under|stand.  |
|00004150| 54 68 65 20 70 61 72 61 | 6d 65 74 65 72 0a 58 2e |The para|meter.X.|
|00004160| 4c 57 20 73 70 0a 58 70 | 6f 69 6e 74 73 20 74 6f |LW sp.Xp|oints to|
|00004170| 20 61 20 73 74 72 69 6e | 67 20 6f 66 20 61 20 63 | a strin|g of a c|
|00004180| 65 72 74 61 69 6e 20 6c | 65 6e 67 74 68 3b 0a 58 |ertain l|ength;.X|
|00004190| 69 66 20 69 74 20 64 6f | 65 73 20 6e 6f 74 20 65 |if it do|es not e|
|000041a0| 78 63 65 65 64 0a 58 2e | 4c 57 20 6d 61 78 6c 65 |xceed.X.|LW maxle|
|000041b0| 6e 67 74 68 20 2c 0a 58 | 74 68 65 20 62 79 74 65 |ngth ,.X|the byte|
|000041c0| 73 20 61 72 65 20 73 65 | 72 69 61 6c 69 7a 65 64 |s are se|rialized|
|000041d0| 2e 0a 58 2e 4c 50 0a 58 | 54 68 65 20 65 66 66 65 |..X.LP.X|The effe|
|000041e0| 63 74 20 6f 66 20 64 65 | 73 65 72 69 61 6c 69 7a |ct of de|serializ|
|000041f0| 69 6e 67 20 61 20 73 74 | 72 69 6e 67 20 69 73 20 |ing a st|ring is |
|00004200| 73 75 62 74 6c 65 2e 0a | 58 46 69 72 73 74 20 74 |subtle..|XFirst t|
|00004210| 68 65 20 6c 65 6e 67 74 | 68 20 6f 66 20 74 68 65 |he lengt|h of the|
|00004220| 20 69 6e 63 6f 6d 69 6e | 67 20 73 74 72 69 6e 67 | incomin|g string|
|00004230| 20 69 73 20 64 65 74 65 | 72 6d 69 6e 65 64 3b 0a | is dete|rmined;.|
|00004240| 58 69 74 20 6d 75 73 74 | 20 6e 6f 74 20 65 78 63 |Xit must| not exc|
|00004250| 65 65 64 0a 58 2e 4c 57 | 20 6d 61 78 6c 65 6e 67 |eed.X.LW| maxleng|
|00004260| 74 68 20 2e 0a 58 4e 65 | 78 74 0a 58 2e 4c 57 20 |th ..XNe|xt.X.LW |
|00004270| 73 70 0a 58 69 73 20 64 | 65 72 65 66 65 72 65 6e |sp.Xis d|ereferen|
|00004280| 63 65 64 3b 20 69 66 20 | 74 68 65 20 74 68 65 20 |ced; if |the the |
|00004290| 76 61 6c 75 65 20 69 73 | 0a 58 2e 4c 57 20 4e 55 |value is|.X.LW NU|
|000042a0| 4c 4c 20 2c 0a 58 74 68 | 65 6e 20 61 20 73 74 72 |LL ,.Xth|en a str|
|000042b0| 69 6e 67 20 6f 66 20 74 | 68 65 20 61 70 70 72 6f |ing of t|he appro|
|000042c0| 70 72 69 61 74 65 20 6c | 65 6e 67 74 68 20 69 73 |priate l|ength is|
|000042d0| 20 61 6c 6c 6f 63 61 74 | 65 64 20 61 6e 64 0a 58 | allocat|ed and.X|
|000042e0| 2e 4c 57 20 2a 73 70 0a | 58 69 73 20 73 65 74 20 |.LW *sp.|Xis set |
|000042f0| 74 6f 20 74 68 69 73 20 | 73 74 72 69 6e 67 2e 0a |to this |string..|
|00004300| 58 49 66 20 74 68 65 20 | 6f 72 69 67 69 6e 61 6c |XIf the |original|
|00004310| 20 76 61 6c 75 65 20 6f | 66 0a 58 2e 4c 57 20 2a | value o|f.X.LW *|
|00004320| 73 70 0a 58 69 73 20 6e | 6f 6e 2d 6e 75 6c 6c 2c |sp.Xis n|on-null,|
|00004330| 20 74 68 65 6e 20 74 68 | 65 20 58 44 52 20 70 61 | then th|e XDR pa|
|00004340| 63 6b 61 67 65 20 61 73 | 73 75 6d 65 73 0a 58 74 |ckage as|sumes.Xt|
|00004350| 68 61 74 20 61 20 74 61 | 72 67 65 74 20 61 72 65 |hat a ta|rget are|
|00004360| 61 20 68 61 73 20 62 65 | 65 6e 20 61 6c 6c 6f 63 |a has be|en alloc|
|00004370| 61 74 65 64 2c 0a 58 77 | 68 69 63 68 20 63 61 6e |ated,.Xw|hich can|
|00004380| 20 68 6f 6c 64 20 73 74 | 72 69 6e 67 73 20 6e 6f | hold st|rings no|
|00004390| 20 6c 6f 6e 67 65 72 20 | 74 68 61 6e 0a 58 2e 4c | longer |than.X.L|
|000043a0| 57 20 6d 61 78 6c 65 6e | 67 74 68 20 2e 0a 58 49 |W maxlen|gth ..XI|
|000043b0| 6e 20 65 69 74 68 65 72 | 20 63 61 73 65 2c 20 74 |n either| case, t|
|000043c0| 68 65 20 73 74 72 69 6e | 67 20 69 73 20 64 65 63 |he strin|g is dec|
|000043d0| 6f 64 65 64 20 69 6e 74 | 6f 20 74 68 65 20 74 61 |oded int|o the ta|
|000043e0| 72 67 65 74 20 61 72 65 | 61 2e 0a 58 54 68 65 20 |rget are|a..XThe |
|000043f0| 72 6f 75 74 69 6e 65 20 | 74 68 65 6e 20 61 70 70 |routine |then app|
|00004400| 65 6e 64 73 20 61 20 6e | 75 6c 6c 20 63 68 61 72 |ends a n|ull char|
|00004410| 61 63 74 65 72 20 74 6f | 20 74 68 65 20 73 74 72 |acter to| the str|
|00004420| 69 6e 67 2e 0a 58 2e 4c | 50 0a 58 49 6e 20 74 68 |ing..X.L|P.XIn th|
|00004430| 65 0a 58 2e 4c 57 20 58 | 44 52 5f 46 52 45 45 0a |e.X.LW X|DR_FREE.|
|00004440| 58 6f 70 65 72 61 74 69 | 6f 6e 2c 20 74 68 65 20 |Xoperati|on, the |
|00004450| 73 74 72 69 6e 67 20 69 | 73 20 6f 62 74 61 69 6e |string i|s obtain|
|00004460| 65 64 20 62 79 20 64 65 | 72 65 66 65 72 65 6e 63 |ed by de|referenc|
|00004470| 69 6e 67 0a 58 2e 4c 57 | 20 73 70 20 2e 0a 58 49 |ing.X.LW| sp ..XI|
|00004480| 66 20 74 68 65 20 73 74 | 72 69 6e 67 20 69 73 20 |f the st|ring is |
|00004490| 6e 6f 74 0a 58 2e 4c 57 | 20 4e 55 4c 4c 20 2c 0a |not.X.LW| NULL ,.|
|000044a0| 58 69 74 20 69 73 20 66 | 72 65 65 64 20 61 6e 64 |Xit is f|reed and|
|000044b0| 0a 58 2e 4c 57 20 2a 73 | 70 0a 58 69 73 20 73 65 |.X.LW *s|p.Xis se|
|000044c0| 74 20 74 6f 0a 58 2e 4c | 57 20 4e 55 4c 4c 20 2e |t to.X.L|W NULL .|
|000044d0| 0a 58 49 6e 20 74 68 69 | 73 20 6f 70 65 72 61 74 |.XIn thi|s operat|
|000044e0| 69 6f 6e 2c 0a 58 2e 4c | 57 20 78 64 72 5f 73 74 |ion,.X.L|W xdr_st|
|000044f0| 72 69 6e 67 0a 58 69 67 | 6e 6f 72 65 73 20 74 68 |ring.Xig|nores th|
|00004500| 65 0a 58 2e 4c 57 20 6d | 61 78 6c 65 6e 67 74 68 |e.X.LW m|axlength|
|00004510| 0a 58 70 61 72 61 6d 65 | 74 65 72 2e 0a 58 2e 4e |.Xparame|ter..X.N|
|00004520| 48 20 33 0a 58 42 79 74 | 65 20 41 72 72 61 79 73 |H 3.XByt|e Arrays|
|00004530| 0a 58 2e 4c 50 0a 58 4f | 66 74 65 6e 20 76 61 72 |.X.LP.XO|ften var|
|00004540| 69 61 62 6c 65 2d 6c 65 | 6e 67 74 68 20 61 72 72 |iable-le|ngth arr|
|00004550| 61 79 73 20 6f 66 20 62 | 79 74 65 73 20 61 72 65 |ays of b|ytes are|
|00004560| 20 70 72 65 66 65 72 61 | 62 6c 65 20 74 6f 20 73 | prefera|ble to s|
|00004570| 74 72 69 6e 67 73 2e 0a | 58 42 79 74 65 20 61 72 |trings..|XByte ar|
|00004580| 72 61 79 73 20 64 69 66 | 66 65 72 20 66 72 6f 6d |rays dif|fer from|
|00004590| 20 73 74 72 69 6e 67 73 | 20 69 6e 20 74 68 65 20 | strings| in the |
|000045a0| 66 6f 6c 6c 6f 77 69 6e | 67 20 74 68 72 65 65 20 |followin|g three |
|000045b0| 77 61 79 73 3a 20 0a 58 | 31 29 20 74 68 65 20 6c |ways: .X|1) the l|
|000045c0| 65 6e 67 74 68 20 6f 66 | 20 74 68 65 20 61 72 72 |ength of| the arr|
|000045d0| 61 79 20 28 74 68 65 20 | 62 79 74 65 20 63 6f 75 |ay (the |byte cou|
|000045e0| 6e 74 29 20 69 73 20 65 | 78 70 6c 69 63 69 74 6c |nt) is e|xplicitl|
|000045f0| 79 0a 58 6c 6f 63 61 74 | 65 64 20 69 6e 20 61 6e |y.Xlocat|ed in an|
|00004600| 20 75 6e 73 69 67 6e 65 | 64 20 69 6e 74 65 67 65 | unsigne|d intege|
|00004610| 72 2c 0a 58 32 29 20 74 | 68 65 20 62 79 74 65 20 |r,.X2) t|he byte |
|00004620| 73 65 71 75 65 6e 63 65 | 20 69 73 20 6e 6f 74 20 |sequence| is not |
|00004630| 74 65 72 6d 69 6e 61 74 | 65 64 20 62 79 20 61 20 |terminat|ed by a |
|00004640| 6e 75 6c 6c 20 63 68 61 | 72 61 63 74 65 72 2c 20 |null cha|racter, |
|00004650| 61 6e 64 0a 58 33 29 20 | 74 68 65 20 65 78 74 65 |and.X3) |the exte|
|00004660| 72 6e 61 6c 20 72 65 70 | 72 65 73 65 6e 74 61 74 |rnal rep|resentat|
|00004670| 69 6f 6e 20 6f 66 20 74 | 68 65 20 62 79 74 65 73 |ion of t|he bytes|
|00004680| 20 69 73 20 74 68 65 20 | 73 61 6d 65 20 61 73 20 | is the |same as |
|00004690| 74 68 65 69 72 0a 58 69 | 6e 74 65 72 6e 61 6c 20 |their.Xi|nternal |
|000046a0| 72 65 70 72 65 73 65 6e | 74 61 74 69 6f 6e 2e 0a |represen|tation..|
|000046b0| 58 54 68 65 20 70 72 69 | 6d 69 74 69 76 65 0a 58 |XThe pri|mitive.X|
|000046c0| 2e 4c 57 20 78 64 72 5f | 62 79 74 65 73 28 29 0a |.LW xdr_|bytes().|
|000046d0| 58 63 6f 6e 76 65 72 74 | 73 20 62 65 74 77 65 65 |Xconvert|s betwee|
|000046e0| 6e 20 74 68 65 20 69 6e | 74 65 72 6e 61 6c 20 61 |n the in|ternal a|
|000046f0| 6e 64 20 65 78 74 65 72 | 6e 61 6c 0a 58 72 65 70 |nd exter|nal.Xrep|
|00004700| 72 65 73 65 6e 74 61 74 | 69 6f 6e 73 20 6f 66 20 |resentat|ions of |
|00004710| 62 79 74 65 20 61 72 72 | 61 79 73 3a 0a 58 2e 4c |byte arr|ays:.X.L|
|00004720| 53 0a 58 62 6f 6f 6c 5f | 74 20 78 64 72 5f 62 79 |S.Xbool_|t xdr_by|
|00004730| 74 65 73 28 78 64 72 73 | 2c 20 62 70 70 2c 20 6c |tes(xdrs|, bpp, l|
|00004740| 70 2c 20 6d 61 78 6c 65 | 6e 67 74 68 29 0a 58 09 |p, maxle|ngth).X.|
|00004750| 58 44 52 20 2a 78 64 72 | 73 3b 0a 58 09 63 68 61 |XDR *xdr|s;.X.cha|
|00004760| 72 20 2a 2a 62 70 70 3b | 0a 58 09 75 5f 69 6e 74 |r **bpp;|.X.u_int|
|00004770| 20 2a 6c 70 3b 0a 58 09 | 75 5f 69 6e 74 20 6d 61 | *lp;.X.|u_int ma|
|00004780| 78 6c 65 6e 67 74 68 3b | 0a 58 2e 4c 66 0a 58 54 |xlength;|.X.Lf.XT|
|00004790| 68 65 20 75 73 61 67 65 | 20 6f 66 20 74 68 65 20 |he usage| of the |
|000047a0| 66 69 72 73 74 2c 20 73 | 65 63 6f 6e 64 20 61 6e |first, s|econd an|
|000047b0| 64 20 66 6f 75 72 74 68 | 20 70 61 72 61 6d 65 74 |d fourth| paramet|
|000047c0| 65 72 73 0a 58 61 72 65 | 20 69 64 65 6e 74 69 63 |ers.Xare| identic|
|000047d0| 61 6c 20 74 6f 20 74 68 | 65 20 66 69 72 73 74 2c |al to th|e first,|
|000047e0| 20 73 65 63 6f 6e 64 20 | 61 6e 64 20 74 68 69 72 | second |and thir|
|000047f0| 64 20 70 61 72 61 6d 65 | 74 65 72 73 20 6f 66 0a |d parame|ters of.|
|00004800| 58 2e 4c 57 20 78 64 72 | 5f 73 74 72 69 6e 67 28 |X.LW xdr|_string(|
|00004810| 29 20 2c 0a 58 72 65 73 | 70 65 63 74 69 76 65 6c |) ,.Xres|pectivel|
|00004820| 79 2e 0a 58 54 68 65 20 | 6c 65 6e 67 74 68 20 6f |y..XThe |length o|
|00004830| 66 20 74 68 65 20 62 79 | 74 65 20 61 72 65 61 20 |f the by|te area |
|00004840| 69 73 20 6f 62 74 61 69 | 6e 65 64 20 62 79 20 64 |is obtai|ned by d|
|00004850| 65 72 65 66 65 72 65 6e | 63 69 6e 67 0a 58 2e 4c |ereferen|cing.X.L|
|00004860| 57 20 6c 70 0a 58 77 68 | 65 6e 20 73 65 72 69 61 |W lp.Xwh|en seria|
|00004870| 6c 69 7a 69 6e 67 3b 0a | 58 2e 4c 57 20 2a 6c 70 |lizing;.|X.LW *lp|
|00004880| 0a 58 69 73 20 73 65 74 | 20 74 6f 20 74 68 65 20 |.Xis set| to the |
|00004890| 62 79 74 65 20 6c 65 6e | 67 74 68 20 77 68 65 6e |byte len|gth when|
|000048a0| 20 64 65 73 65 72 69 61 | 6c 69 7a 69 6e 67 2e 0a | deseria|lizing..|
|000048b0| 58 2e 4e 48 20 33 0a 58 | 41 72 72 61 79 73 0a 58 |X.NH 3.X|Arrays.X|
|000048c0| 2e 4c 50 0a 58 54 68 65 | 20 58 44 52 20 6c 69 62 |.LP.XThe| XDR lib|
|000048d0| 72 61 72 79 20 70 61 63 | 6b 61 67 65 20 70 72 6f |rary pac|kage pro|
|000048e0| 76 69 64 65 73 20 61 20 | 70 72 69 6d 69 74 69 76 |vides a |primitiv|
|000048f0| 65 0a 58 66 6f 72 20 68 | 61 6e 64 6c 69 6e 67 20 |e.Xfor h|andling |
|00004900| 61 72 72 61 79 73 20 6f | 66 20 61 72 62 69 74 72 |arrays o|f arbitr|
|00004910| 61 72 79 20 65 6c 65 6d | 65 6e 74 73 2e 0a 58 54 |ary elem|ents..XT|
|00004920| 68 65 0a 58 2e 4c 57 20 | 78 64 72 5f 62 79 74 65 |he.X.LW |xdr_byte|
|00004930| 73 28 29 0a 58 72 6f 75 | 74 69 6e 65 20 74 72 65 |s().Xrou|tine tre|
|00004940| 61 74 73 20 61 20 73 75 | 62 73 65 74 20 6f 66 20 |ats a su|bset of |
|00004950| 67 65 6e 65 72 69 63 20 | 61 72 72 61 79 73 2c 0a |generic |arrays,.|
|00004960| 58 69 6e 20 77 68 69 63 | 68 20 74 68 65 20 73 69 |Xin whic|h the si|
|00004970| 7a 65 20 6f 66 20 61 72 | 72 61 79 20 65 6c 65 6d |ze of ar|ray elem|
|00004980| 65 6e 74 73 20 69 73 20 | 6b 6e 6f 77 6e 20 74 6f |ents is |known to|
|00004990| 20 62 65 20 31 2c 0a 58 | 61 6e 64 20 74 68 65 20 | be 1,.X|and the |
|000049a0| 65 78 74 65 72 6e 61 6c | 20 64 65 73 63 72 69 70 |external| descrip|
|000049b0| 74 69 6f 6e 20 6f 66 20 | 65 61 63 68 20 65 6c 65 |tion of |each ele|
|000049c0| 6d 65 6e 74 20 69 73 20 | 62 75 69 6c 74 2d 69 6e |ment is |built-in|
|000049d0| 2e 0a 58 54 68 65 20 67 | 65 6e 65 72 69 63 20 61 |..XThe g|eneric a|
|000049e0| 72 72 61 79 20 70 72 69 | 6d 69 74 69 76 65 2c 0a |rray pri|mitive,.|
|000049f0| 58 2e 4c 57 20 78 64 72 | 5f 61 72 72 61 79 28 29 |X.LW xdr|_array()|
|00004a00| 0a 58 72 65 71 75 69 72 | 65 73 20 70 61 72 61 6d |.Xrequir|es param|
|00004a10| 65 74 65 72 73 20 69 64 | 65 6e 74 69 63 61 6c 20 |eters id|entical |
|00004a20| 74 6f 20 74 68 6f 73 65 | 20 6f 66 0a 58 2e 4c 57 |to those| of.X.LW|
|00004a30| 20 78 64 72 5f 62 79 74 | 65 73 28 29 0a 58 70 6c | xdr_byt|es().Xpl|
|00004a40| 75 73 20 74 77 6f 20 6d | 6f 72 65 3a 0a 58 74 68 |us two m|ore:.Xth|
|00004a50| 65 20 73 69 7a 65 20 6f | 66 20 61 72 72 61 79 20 |e size o|f array |
|00004a60| 65 6c 65 6d 65 6e 74 73 | 2c 0a 58 61 6e 64 20 61 |elements|,.Xand a|
|00004a70| 6e 20 58 44 52 20 72 6f | 75 74 69 6e 65 20 74 6f |n XDR ro|utine to|
|00004a80| 20 68 61 6e 64 6c 65 20 | 65 61 63 68 20 6f 66 20 | handle |each of |
|00004a90| 74 68 65 20 65 6c 65 6d | 65 6e 74 73 2e 0a 58 54 |the elem|ents..XT|
|00004aa0| 68 69 73 20 72 6f 75 74 | 69 6e 65 20 69 73 20 63 |his rout|ine is c|
|00004ab0| 61 6c 6c 65 64 20 74 6f | 20 65 6e 63 6f 64 65 20 |alled to| encode |
|00004ac0| 6f 72 20 64 65 63 6f 64 | 65 0a 58 65 61 63 68 20 |or decod|e.Xeach |
|00004ad0| 65 6c 65 6d 65 6e 74 20 | 6f 66 20 74 68 65 20 61 |element |of the a|
|00004ae0| 72 72 61 79 2e 0a 58 2e | 4c 53 0a 58 62 6f 6f 6c |rray..X.|LS.Xbool|
|00004af0| 5f 74 0a 58 78 64 72 5f | 61 72 72 61 79 28 78 64 |_t.Xxdr_|array(xd|
|00004b00| 72 73 2c 20 61 70 2c 20 | 6c 70 2c 20 6d 61 78 6c |rs, ap, |lp, maxl|
|00004b10| 65 6e 67 74 68 2c 20 65 | 6c 65 6d 65 6e 74 73 69 |ength, e|lementsi|
|00004b20| 7a 2c 20 78 64 72 5f 65 | 6c 65 6d 65 6e 74 29 0a |z, xdr_e|lement).|
|00004b30| 58 09 58 44 52 20 2a 78 | 64 72 73 3b 0a 58 09 63 |X.XDR *x|drs;.X.c|
|00004b40| 68 61 72 20 2a 2a 61 70 | 3b 0a 58 09 75 5f 69 6e |har **ap|;.X.u_in|
|00004b50| 74 20 2a 6c 70 3b 0a 58 | 09 75 5f 69 6e 74 20 6d |t *lp;.X|.u_int m|
|00004b60| 61 78 6c 65 6e 67 74 68 | 3b 0a 58 09 75 5f 69 6e |axlength|;.X.u_in|
|00004b70| 74 20 65 6c 65 6d 65 6e | 74 73 69 7a 3b 0a 58 09 |t elemen|tsiz;.X.|
|00004b80| 62 6f 6f 6c 5f 74 20 28 | 2a 78 64 72 5f 65 6c 65 |bool_t (|*xdr_ele|
|00004b90| 6d 65 6e 74 29 28 29 3b | 0a 58 2e 4c 66 0a 58 54 |ment)();|.X.Lf.XT|
|00004ba0| 68 65 20 70 61 72 61 6d | 65 74 65 72 0a 58 2e 4c |he param|eter.X.L|
|00004bb0| 57 20 61 70 0a 58 69 73 | 20 74 68 65 20 61 64 64 |W ap.Xis| the add|
|00004bc0| 72 65 73 73 20 6f 66 20 | 74 68 65 20 70 6f 69 6e |ress of |the poin|
|00004bd0| 74 65 72 20 74 6f 20 74 | 68 65 20 61 72 72 61 79 |ter to t|he array|
|00004be0| 2e 0a 58 49 66 0a 58 2e | 4c 57 20 2a 61 70 0a 58 |..XIf.X.|LW *ap.X|
|00004bf0| 69 73 0a 58 2e 4c 57 20 | 4e 55 4c 4c 0a 58 77 68 |is.X.LW |NULL.Xwh|
|00004c00| 65 6e 20 74 68 65 20 61 | 72 72 61 79 20 69 73 20 |en the a|rray is |
|00004c10| 62 65 69 6e 67 20 64 65 | 73 65 72 69 61 6c 69 7a |being de|serializ|
|00004c20| 65 64 2c 0a 58 58 44 52 | 20 61 6c 6c 6f 63 61 74 |ed,.XXDR| allocat|
|00004c30| 65 73 20 61 6e 20 61 72 | 72 61 79 20 6f 66 20 74 |es an ar|ray of t|
|00004c40| 68 65 20 61 70 70 72 6f | 70 72 69 61 74 65 20 73 |he appro|priate s|
|00004c50| 69 7a 65 20 61 6e 64 20 | 73 65 74 73 0a 58 2e 4c |ize and |sets.X.L|
|00004c60| 57 20 2a 61 70 0a 58 74 | 6f 20 74 68 61 74 20 61 |W *ap.Xt|o that a|
|00004c70| 72 72 61 79 2e 0a 58 54 | 68 65 20 65 6c 65 6d 65 |rray..XT|he eleme|
|00004c80| 6e 74 20 63 6f 75 6e 74 | 20 6f 66 20 74 68 65 20 |nt count| of the |
|00004c90| 61 72 72 61 79 20 69 73 | 20 6f 62 74 61 69 6e 65 |array is| obtaine|
|00004ca0| 64 20 66 72 6f 6d 0a 58 | 2e 4c 57 20 2a 6c 70 0a |d from.X|.LW *lp.|
|00004cb0| 58 77 68 65 6e 20 74 68 | 65 20 61 72 72 61 79 20 |Xwhen th|e array |
|00004cc0| 69 73 20 73 65 72 69 61 | 6c 69 7a 65 64 3b 0a 58 |is seria|lized;.X|
|00004cd0| 2e 4c 57 20 2a 6c 70 0a | 58 69 73 20 73 65 74 20 |.LW *lp.|Xis set |
|00004ce0| 74 6f 20 74 68 65 20 61 | 72 72 61 79 20 6c 65 6e |to the a|rray len|
|00004cf0| 67 74 68 20 77 68 65 6e | 20 74 68 65 20 61 72 72 |gth when| the arr|
|00004d00| 61 79 20 69 73 20 64 65 | 73 65 72 69 61 6c 69 7a |ay is de|serializ|
|00004d10| 65 64 2e 20 0a 58 54 68 | 65 20 70 61 72 61 6d 65 |ed. .XTh|e parame|
|00004d20| 74 65 72 0a 58 2e 4c 57 | 20 6d 61 78 6c 65 6e 67 |ter.X.LW| maxleng|
|00004d30| 74 68 0a 58 69 73 20 74 | 68 65 20 6d 61 78 69 6d |th.Xis t|he maxim|
|00004d40| 75 6d 20 6e 75 6d 62 65 | 72 20 6f 66 20 65 6c 65 |um numbe|r of ele|
|00004d50| 6d 65 6e 74 73 20 74 68 | 61 74 20 74 68 65 20 61 |ments th|at the a|
|00004d60| 72 72 61 79 20 69 73 20 | 61 6c 6c 6f 77 65 64 20 |rray is |allowed |
|00004d70| 74 6f 20 68 61 76 65 3b | 0a 58 2e 4c 57 20 65 6c |to have;|.X.LW el|
|00004d80| 65 6d 65 6e 74 73 69 7a | 0a 58 69 73 20 74 68 65 |ementsiz|.Xis the|
|00004d90| 20 62 79 74 65 20 73 69 | 7a 65 20 6f 66 20 65 61 | byte si|ze of ea|
|00004da0| 63 68 20 65 6c 65 6d 65 | 6e 74 20 6f 66 20 74 68 |ch eleme|nt of th|
|00004db0| 65 20 61 72 72 61 79 0a | 58 28 74 68 65 20 43 20 |e array.|X(the C |
|00004dc0| 66 75 6e 63 74 69 6f 6e | 0a 58 2e 4c 57 20 73 69 |function|.X.LW si|
|00004dd0| 7a 65 6f 66 28 29 0a 58 | 63 61 6e 20 62 65 20 75 |zeof().X|can be u|
|00004de0| 73 65 64 20 74 6f 20 6f | 62 74 61 69 6e 20 74 68 |sed to o|btain th|
|00004df0| 69 73 20 76 61 6c 75 65 | 29 2e 0a 58 54 68 65 20 |is value|)..XThe |
|00004e00| 72 6f 75 74 69 6e 65 0a | 58 2e 4c 57 20 78 64 72 |routine.|X.LW xdr|
|00004e10| 5f 65 6c 65 6d 65 6e 74 | 0a 58 69 73 20 63 61 6c |_element|.Xis cal|
|00004e20| 6c 65 64 20 74 6f 20 73 | 65 72 69 61 6c 69 7a 65 |led to s|erialize|
|00004e30| 2c 20 64 65 73 65 72 69 | 61 6c 69 7a 65 2c 20 6f |, deseri|alize, o|
|00004e40| 72 20 66 72 65 65 0a 58 | 65 61 63 68 20 65 6c 65 |r free.X|each ele|
|00004e50| 6d 65 6e 74 20 6f 66 20 | 74 68 65 20 61 72 72 61 |ment of |the arra|
|00004e60| 79 2e 0a 58 2e 4e 48 20 | 34 0a 58 45 78 61 6d 70 |y..X.NH |4.XExamp|
|00004e70| 6c 65 73 0a 58 2e 4c 50 | 0a 58 42 65 66 6f 72 65 |les.X.LP|.XBefore|
|00004e80| 20 64 65 66 69 6e 69 6e | 67 20 6d 6f 72 65 20 63 | definin|g more c|
|00004e90| 6f 6e 73 74 72 75 63 74 | 65 64 20 64 61 74 61 20 |onstruct|ed data |
|00004ea0| 74 79 70 65 73 2c 0a 58 | 69 74 20 69 73 20 61 70 |types,.X|it is ap|
|00004eb0| 70 72 6f 70 72 69 61 74 | 65 20 74 6f 20 70 72 65 |propriat|e to pre|
|00004ec0| 73 65 6e 74 20 74 68 72 | 65 65 20 65 78 61 6d 70 |sent thr|ee examp|
|00004ed0| 6c 65 73 2e 0a 58 2e 4c | 50 0a 58 2e 49 20 22 45 |les..X.L|P.X.I "E|
|00004ee0| 78 61 6d 70 6c 65 20 41 | 22 0a 58 2e 4c 50 0a 58 |xample A|".X.LP.X|
|00004ef0| 41 20 75 73 65 72 20 6f | 6e 20 61 20 6e 65 74 77 |A user o|n a netw|
|00004f00| 6f 72 6b 65 64 20 6d 61 | 63 68 69 6e 65 20 63 61 |orked ma|chine ca|
|00004f10| 6e 20 62 65 20 69 64 65 | 6e 74 69 66 69 65 64 20 |n be ide|ntified |
|00004f20| 62 79 20 0a 58 28 61 29 | 20 74 68 65 20 6d 61 63 |by .X(a)| the mac|
|00004f30| 68 69 6e 65 20 6e 61 6d | 65 2c 20 73 75 63 68 20 |hine nam|e, such |
|00004f40| 61 73 0a 58 2e 4c 57 20 | 6b 72 79 70 74 6f 6e 20 |as.X.LW |krypton |
|00004f50| 3a 0a 58 73 65 65 0a 58 | 2e 49 20 67 65 74 68 6f |:.Xsee.X|.I getho|
|00004f60| 73 74 6e 61 6d 65 20 28 | 33 29 3b 0a 58 28 62 29 |stname (|3);.X(b)|
|00004f70| 20 74 68 65 20 75 73 65 | 72 27 73 20 55 49 44 3a | the use|r's UID:|
|00004f80| 20 73 65 65 0a 58 2e 49 | 20 67 65 74 65 75 69 64 | see.X.I| geteuid|
|00004f90| 20 28 32 29 3b 0a 58 61 | 6e 64 20 28 63 29 20 74 | (2);.Xa|nd (c) t|
|00004fa0| 68 65 20 67 72 6f 75 70 | 20 6e 75 6d 62 65 72 73 |he group| numbers|
|00004fb0| 20 74 6f 20 77 68 69 63 | 68 20 74 68 65 20 75 73 | to whic|h the us|
|00004fc0| 65 72 20 62 65 6c 6f 6e | 67 73 3a 20 73 65 65 0a |er belon|gs: see.|
|00004fd0| 58 2e 49 20 67 65 74 67 | 72 6f 75 70 73 20 28 32 |X.I getg|roups (2|
|00004fe0| 29 2e 0a 58 41 20 73 74 | 72 75 63 74 75 72 65 20 |)..XA st|ructure |
|00004ff0| 77 69 74 68 20 74 68 69 | 73 20 69 6e 66 6f 72 6d |with thi|s inform|
|00005000| 61 74 69 6f 6e 20 61 6e | 64 20 69 74 73 20 61 73 |ation an|d its as|
|00005010| 73 6f 63 69 61 74 65 64 | 20 58 44 52 20 72 6f 75 |sociated| XDR rou|
|00005020| 74 69 6e 65 0a 58 63 6f | 75 6c 64 20 62 65 20 63 |tine.Xco|uld be c|
|00005030| 6f 64 65 64 20 6c 69 6b | 65 20 74 68 69 73 3a 0a |oded lik|e this:.|
|00005040| 58 2e 4c 53 0a 58 73 74 | 72 75 63 74 20 6e 65 74 |X.LS.Xst|ruct net|
|00005050| 75 73 65 72 20 7b 0a 58 | 09 63 68 61 72 09 2a 6e |user {.X|.char.*n|
|00005060| 75 5f 6d 61 63 68 69 6e | 65 6e 61 6d 65 3b 0a 58 |u_machin|ename;.X|
|00005070| 09 69 6e 74 20 09 6e 75 | 5f 75 69 64 3b 0a 58 09 |.int .nu|_uid;.X.|
|00005080| 75 5f 69 6e 74 09 6e 75 | 5f 67 6c 65 6e 3b 0a 58 |u_int.nu|_glen;.X|
|00005090| 09 69 6e 74 20 09 2a 6e | 75 5f 67 69 64 73 3b 0a |.int .*n|u_gids;.|
|000050a0| 58 7d 3b 0a 58 23 64 65 | 66 69 6e 65 20 4e 4c 45 |X};.X#de|fine NLE|
|000050b0| 4e 20 32 35 35 09 2f 2a | 20 6d 61 63 68 69 6e 65 |N 255./*| machine|
|000050c0| 20 6e 61 6d 65 73 20 3c | 20 32 35 36 20 63 68 61 | names <| 256 cha|
|000050d0| 72 73 20 2a 2f 0a 58 23 | 64 65 66 69 6e 65 20 4e |rs */.X#|define N|
|000050e0| 47 52 50 53 20 32 30 09 | 2f 2a 20 75 73 65 72 20 |GRPS 20.|/* user |
|000050f0| 63 61 6e 27 74 20 62 65 | 20 69 6e 20 3e 20 32 30 |can't be| in > 20|
|00005100| 20 67 72 6f 75 70 73 20 | 2a 2f 0a 58 2e 73 70 2e | groups |*/.X.sp.|
|00005110| 35 0a 58 62 6f 6f 6c 5f | 74 0a 58 78 64 72 5f 6e |5.Xbool_|t.Xxdr_n|
|00005120| 65 74 75 73 65 72 28 78 | 64 72 73 2c 20 6e 75 70 |etuser(x|drs, nup|
|00005130| 29 0a 58 09 58 44 52 20 | 2a 78 64 72 73 3b 0a 58 |).X.XDR |*xdrs;.X|
|00005140| 09 73 74 72 75 63 74 20 | 6e 65 74 75 73 65 72 20 |.struct |netuser |
|00005150| 2a 6e 75 70 3b 0a 58 7b | 0a 58 09 72 65 74 75 72 |*nup;.X{|.X.retur|
|00005160| 6e 28 78 64 72 5f 73 74 | 72 69 6e 67 28 78 64 72 |n(xdr_st|ring(xdr|
|00005170| 73 2c 20 26 6e 75 70 2d | 3e 6e 75 5f 6d 61 63 68 |s, &nup-|>nu_mach|
|00005180| 69 6e 65 6e 61 6d 65 2c | 20 4e 4c 45 4e 29 20 26 |inename,| NLEN) &|
|00005190| 26 0a 58 09 20 20 20 20 | 78 64 72 5f 69 6e 74 28 |&.X.    |xdr_int(|
|000051a0| 78 64 72 73 2c 20 26 6e | 75 70 2d 3e 6e 75 5f 75 |xdrs, &n|up->nu_u|
|000051b0| 69 64 29 20 26 26 0a 58 | 09 20 20 20 20 78 64 72 |id) &&.X|.    xdr|
|000051c0| 5f 61 72 72 61 79 28 78 | 64 72 73 2c 20 26 6e 75 |_array(x|drs, &nu|
|000051d0| 70 2d 3e 6e 75 5f 67 69 | 64 73 2c 20 26 6e 75 70 |p->nu_gi|ds, &nup|
|000051e0| 2d 3e 6e 75 5f 67 6c 65 | 6e 2c 20 4e 47 52 50 53 |->nu_gle|n, NGRPS|
|000051f0| 2c 0a 58 09 09 73 69 7a | 65 6f 66 20 28 69 6e 74 |,.X..siz|eof (int|
|00005200| 29 2c 20 78 64 72 5f 69 | 6e 74 29 29 3b 0a 58 7d |), xdr_i|nt));.X}|
|00005210| 0a 58 2e 4c 66 0a 58 2e | 4c 50 0a 58 2e 49 20 22 |.X.Lf.X.|LP.X.I "|
|00005220| 45 78 61 6d 70 6c 65 20 | 42 22 0a 58 2e 4c 50 0a |Example |B".X.LP.|
|00005230| 58 41 20 70 61 72 74 79 | 20 6f 66 20 6e 65 74 77 |XA party| of netw|
|00005240| 6f 72 6b 20 75 73 65 72 | 73 20 63 6f 75 6c 64 20 |ork user|s could |
|00005250| 62 65 20 69 6d 70 6c 65 | 6d 65 6e 74 65 64 0a 58 |be imple|mented.X|
|00005260| 61 73 20 61 6e 20 61 72 | 72 61 79 20 6f 66 0a 58 |as an ar|ray of.X|
|00005270| 2e 4c 57 20 6e 65 74 75 | 73 65 72 0a 58 73 74 72 |.LW netu|ser.Xstr|
|00005280| 75 63 74 75 72 65 2e 0a | 58 54 68 65 20 64 65 63 |ucture..|XThe dec|
|00005290| 6c 61 72 61 74 69 6f 6e | 20 61 6e 64 20 69 74 73 |laration| and its|
|000052a0| 20 61 73 73 6f 63 69 61 | 74 65 64 20 58 44 52 20 | associa|ted XDR |
|000052b0| 72 6f 75 74 69 6e 65 73 | 0a 58 61 72 65 20 61 73 |routines|.Xare as|
|000052c0| 20 66 6f 6c 6c 6f 77 73 | 3a 0a 58 2e 4c 53 0a 58 | follows|:.X.LS.X|
|000052d0| 73 74 72 75 63 74 20 70 | 61 72 74 79 20 7b 0a 58 |struct p|arty {.X|
|000052e0| 09 75 5f 69 6e 74 20 70 | 5f 6c 65 6e 3b 0a 58 09 |.u_int p|_len;.X.|
|000052f0| 73 74 72 75 63 74 20 6e | 65 74 75 73 65 72 20 2a |struct n|etuser *|
|00005300| 70 5f 6e 75 73 65 72 73 | 3b 0a 58 7d 3b 0a 58 23 |p_nusers|;.X};.X#|
|00005310| 64 65 66 69 6e 65 20 50 | 4c 45 4e 20 35 30 30 20 |define P|LEN 500 |
|00005320| 2f 2a 20 6d 61 78 20 6e | 75 6d 62 65 72 20 6f 66 |/* max n|umber of|
|00005330| 20 75 73 65 72 73 20 69 | 6e 20 61 20 70 61 72 74 | users i|n a part|
|00005340| 79 20 2a 2f 0a 58 2e 73 | 70 2e 35 0a 58 62 6f 6f |y */.X.s|p.5.Xboo|
|00005350| 6c 5f 74 0a 58 78 64 72 | 5f 70 61 72 74 79 28 78 |l_t.Xxdr|_party(x|
|00005360| 64 72 73 2c 20 70 70 29 | 0a 58 09 58 44 52 20 2a |drs, pp)|.X.XDR *|
|00005370| 78 64 72 73 3b 0a 58 09 | 73 74 72 75 63 74 20 70 |xdrs;.X.|struct p|
|00005380| 61 72 74 79 20 2a 70 70 | 3b 0a 58 7b 0a 58 09 72 |arty *pp|;.X{.X.r|
|00005390| 65 74 75 72 6e 28 78 64 | 72 5f 61 72 72 61 79 28 |eturn(xd|r_array(|
|000053a0| 78 64 72 73 2c 20 26 70 | 70 2d 3e 70 5f 6e 75 73 |xdrs, &p|p->p_nus|
|000053b0| 65 72 73 2c 20 26 70 70 | 2d 3e 70 5f 6c 65 6e 2c |ers, &pp|->p_len,|
|000053c0| 20 50 4c 45 4e 2c 0a 58 | 09 20 20 20 20 73 69 7a | PLEN,.X|.    siz|
|000053d0| 65 6f 66 20 28 73 74 72 | 75 63 74 20 6e 65 74 75 |eof (str|uct netu|
|000053e0| 73 65 72 29 2c 20 78 64 | 72 5f 6e 65 74 75 73 65 |ser), xd|r_netuse|
|000053f0| 72 29 29 3b 0a 58 7d 0a | 58 2e 4c 66 0a 58 2e 4c |r));.X}.|X.Lf.X.L|
|00005400| 50 0a 58 2e 49 20 22 45 | 78 61 6d 70 6c 65 20 43 |P.X.I "E|xample C|
|00005410| 22 0a 58 2e 4c 50 0a 58 | 54 68 65 20 77 65 6c 6c |".X.LP.X|The well|
|00005420| 2d 6b 6e 6f 77 6e 20 70 | 61 72 61 6d 65 74 65 72 |-known p|arameter|
|00005430| 73 20 74 6f 0a 58 2e 4c | 57 20 6d 61 69 6e 28 29 |s to.X.L|W main()|
|00005440| 20 2c 0a 58 2e 4c 57 20 | 61 72 67 63 0a 58 61 6e | ,.X.LW |argc.Xan|
|00005450| 64 0a 58 2e 4c 57 20 61 | 72 67 76 0a 58 63 61 6e |d.X.LW a|rgv.Xcan|
|00005460| 20 62 65 20 63 6f 6d 62 | 69 6e 65 64 20 69 6e 74 | be comb|ined int|
|00005470| 6f 20 61 20 73 74 72 75 | 63 74 75 72 65 2e 0a 58 |o a stru|cture..X|
|00005480| 41 6e 20 61 72 72 61 79 | 20 6f 66 20 74 68 65 73 |An array| of thes|
|00005490| 65 20 73 74 72 75 63 74 | 75 72 65 73 20 63 61 6e |e struct|ures can|
|000054a0| 20 6d 61 6b 65 20 75 70 | 20 61 20 68 69 73 74 6f | make up| a histo|
|000054b0| 72 79 20 6f 66 20 63 6f | 6d 6d 61 6e 64 73 2e 0a |ry of co|mmands..|
|000054c0| 58 54 68 65 20 64 65 63 | 6c 61 72 61 74 69 6f 6e |XThe dec|laration|
|000054d0| 73 20 61 6e 64 20 58 44 | 52 20 72 6f 75 74 69 6e |s and XD|R routin|
|000054e0| 65 73 20 6d 69 67 68 74 | 20 6c 6f 6f 6b 20 6c 69 |es might| look li|
|000054f0| 6b 65 3a 0a 58 2e 4c 53 | 20 6e 6f 0a 58 73 74 72 |ke:.X.LS| no.Xstr|
|00005500| 75 63 74 20 63 6d 64 20 | 7b 0a 58 09 75 5f 69 6e |uct cmd |{.X.u_in|
|00005510| 74 20 63 5f 61 72 67 63 | 3b 0a 58 09 63 68 61 72 |t c_argc|;.X.char|
|00005520| 20 2a 2a 63 5f 61 72 67 | 76 3b 0a 58 7d 3b 0a 58 | **c_arg|v;.X};.X|
|00005530| 23 64 65 66 69 6e 65 20 | 41 4c 45 4e 20 31 30 30 |#define |ALEN 100|
|00005540| 30 09 2f 2a 20 61 72 67 | 73 20 63 61 6e 6e 6f 74 |0./* arg|s cannot|
|00005550| 20 62 65 20 3e 20 31 30 | 30 30 20 63 68 61 72 73 | be > 10|00 chars|
|00005560| 20 2a 2f 0a 58 23 64 65 | 66 69 6e 65 20 4e 41 52 | */.X#de|fine NAR|
|00005570| 47 43 20 31 30 30 09 2f | 2a 20 63 6f 6d 6d 61 6e |GC 100./|* comman|
|00005580| 64 73 20 63 61 6e 6e 6f | 74 20 68 61 76 65 20 3e |ds canno|t have >|
|00005590| 20 31 30 30 20 61 72 67 | 73 20 2a 2f 0a 58 2e 73 | 100 arg|s */.X.s|
|000055a0| 70 2e 35 0a 58 73 74 72 | 75 63 74 20 68 69 73 74 |p.5.Xstr|uct hist|
|000055b0| 6f 72 79 20 7b 0a 58 09 | 75 5f 69 6e 74 20 68 5f |ory {.X.|u_int h_|
|000055c0| 6c 65 6e 3b 0a 58 09 73 | 74 72 75 63 74 20 63 6d |len;.X.s|truct cm|
|000055d0| 64 20 2a 68 5f 63 6d 64 | 73 3b 0a 58 7d 3b 0a 58 |d *h_cmd|s;.X};.X|
|000055e0| 23 64 65 66 69 6e 65 20 | 4e 43 4d 44 53 20 37 35 |#define |NCMDS 75|
|000055f0| 20 20 2f 2a 20 68 69 73 | 74 6f 72 79 20 69 73 20 |  /* his|tory is |
|00005600| 6e 6f 20 6d 6f 72 65 20 | 74 68 61 6e 20 37 35 20 |no more |than 75 |
|00005610| 63 6f 6d 6d 61 6e 64 73 | 20 2a 2f 0a 58 2e 73 70 |commands| */.X.sp|
|00005620| 2e 35 0a 58 62 6f 6f 6c | 5f 74 0a 58 78 64 72 5f |.5.Xbool|_t.Xxdr_|
|00005630| 77 72 61 70 5f 73 74 72 | 69 6e 67 28 78 64 72 73 |wrap_str|ing(xdrs|
|00005640| 2c 20 73 70 29 0a 58 09 | 58 44 52 20 2a 78 64 72 |, sp).X.|XDR *xdr|
|00005650| 73 3b 0a 58 09 63 68 61 | 72 20 2a 2a 73 70 3b 0a |s;.X.cha|r **sp;.|
|00005660| 58 7b 0a 58 09 72 65 74 | 75 72 6e 28 78 64 72 5f |X{.X.ret|urn(xdr_|
|00005670| 73 74 72 69 6e 67 28 78 | 64 72 73 2c 20 73 70 2c |string(x|drs, sp,|
|00005680| 20 41 4c 45 4e 29 29 3b | 0a 58 7d 0a 58 2e 73 70 | ALEN));|.X}.X.sp|
|00005690| 2e 35 0a 58 62 6f 6f 6c | 5f 74 0a 58 78 64 72 5f |.5.Xbool|_t.Xxdr_|
|000056a0| 63 6d 64 28 78 64 72 73 | 2c 20 63 70 29 0a 58 09 |cmd(xdrs|, cp).X.|
|000056b0| 58 44 52 20 2a 78 64 72 | 73 3b 0a 58 09 73 74 72 |XDR *xdr|s;.X.str|
|000056c0| 75 63 74 20 63 6d 64 20 | 2a 63 70 3b 0a 58 7b 0a |uct cmd |*cp;.X{.|
|000056d0| 58 09 72 65 74 75 72 6e | 28 78 64 72 5f 61 72 72 |X.return|(xdr_arr|
|000056e0| 61 79 28 78 64 72 73 2c | 20 26 63 70 2d 3e 63 5f |ay(xdrs,| &cp->c_|
|000056f0| 61 72 67 76 2c 20 26 63 | 70 2d 3e 63 5f 61 72 67 |argv, &c|p->c_arg|
|00005700| 63 2c 20 4e 41 52 47 43 | 2c 0a 58 09 20 20 20 20 |c, NARGC|,.X.    |
|00005710| 73 69 7a 65 6f 66 20 28 | 63 68 61 72 20 2a 29 2c |sizeof (|char *),|
|00005720| 20 78 64 72 5f 77 72 61 | 70 5f 73 74 72 69 6e 67 | xdr_wra|p_string|
|00005730| 29 29 3b 0a 58 7d 0a 58 | 2e 73 70 2e 35 0a 58 62 |));.X}.X|.sp.5.Xb|
|00005740| 6f 6f 6c 5f 74 0a 58 78 | 64 72 5f 68 69 73 74 6f |ool_t.Xx|dr_histo|
|00005750| 72 79 28 78 64 72 73 2c | 20 68 70 29 0a 58 09 58 |ry(xdrs,| hp).X.X|
|00005760| 44 52 20 2a 78 64 72 73 | 3b 0a 58 09 73 74 72 75 |DR *xdrs|;.X.stru|
|00005770| 63 74 20 68 69 73 74 6f | 72 79 20 2a 68 70 3b 0a |ct histo|ry *hp;.|
|00005780| 58 7b 0a 58 09 72 65 74 | 75 72 6e 28 78 64 72 5f |X{.X.ret|urn(xdr_|
|00005790| 61 72 72 61 79 28 78 64 | 72 73 2c 20 26 68 70 2d |array(xd|rs, &hp-|
|000057a0| 3e 68 5f 63 6d 64 73 2c | 20 26 68 70 2d 3e 68 5f |>h_cmds,| &hp->h_|
|000057b0| 6c 65 6e 2c 20 4e 43 4d | 44 53 2c 0a 58 09 20 20 |len, NCM|DS,.X.  |
|000057c0| 20 20 73 69 7a 65 6f 66 | 20 28 73 74 72 75 63 74 |  sizeof| (struct|
|000057d0| 20 63 6d 64 29 2c 20 78 | 64 72 5f 63 6d 64 29 29 | cmd), x|dr_cmd))|
|000057e0| 3b 0a 58 7d 0a 58 2e 4c | 66 0a 58 54 68 65 20 6d |;.X}.X.L|f.XThe m|
|000057f0| 6f 73 74 20 63 6f 6e 66 | 75 73 69 6e 67 20 70 61 |ost conf|using pa|
|00005800| 72 74 20 6f 66 20 74 68 | 69 73 20 65 78 61 6d 70 |rt of th|is examp|
|00005810| 6c 65 20 69 73 20 74 68 | 61 74 20 74 68 65 20 72 |le is th|at the r|
|00005820| 6f 75 74 69 6e 65 0a 58 | 2e 4c 57 20 78 64 72 5f |outine.X|.LW xdr_|
|00005830| 77 72 61 70 5f 73 74 72 | 69 6e 67 28 29 0a 58 69 |wrap_str|ing().Xi|
|00005840| 73 20 6e 65 65 64 65 64 | 20 74 6f 20 70 61 63 6b |s needed| to pack|
|00005850| 61 67 65 20 74 68 65 0a | 58 2e 4c 57 20 78 64 72 |age the.|X.LW xdr|
|00005860| 5f 73 74 72 69 6e 67 28 | 29 0a 58 72 6f 75 74 69 |_string(|).Xrouti|
|00005870| 6e 65 2c 20 62 65 63 61 | 75 73 65 20 74 68 65 20 |ne, beca|use the |
|00005880| 69 6d 70 6c 65 6d 65 6e | 74 61 74 69 6f 6e 20 6f |implemen|tation o|
|00005890| 66 0a 58 2e 4c 57 20 78 | 64 72 5f 61 72 72 61 79 |f.X.LW x|dr_array|
|000058a0| 28 29 0a 58 6f 6e 6c 79 | 20 70 61 73 73 65 73 20 |().Xonly| passes |
|000058b0| 74 77 6f 20 70 61 72 61 | 6d 65 74 65 72 73 20 74 |two para|meters t|
|000058c0| 6f 20 74 68 65 20 61 72 | 72 61 79 20 65 6c 65 6d |o the ar|ray elem|
|000058d0| 65 6e 74 20 64 65 73 63 | 72 69 70 74 69 6f 6e 20 |ent desc|ription |
|000058e0| 72 6f 75 74 69 6e 65 3b | 0a 58 2e 4c 57 20 78 64 |routine;|.X.LW xd|
|000058f0| 72 5f 77 72 61 70 5f 73 | 74 72 69 6e 67 28 29 0a |r_wrap_s|tring().|
|00005900| 58 73 75 70 70 6c 69 65 | 73 20 74 68 65 20 74 68 |Xsupplie|s the th|
|00005910| 69 72 64 20 70 61 72 61 | 6d 65 74 65 72 20 74 6f |ird para|meter to|
|00005920| 0a 58 2e 4c 57 20 78 64 | 72 5f 73 74 72 69 6e 67 |.X.LW xd|r_string|
|00005930| 28 29 20 2e 0a 58 2e 4c | 50 0a 58 42 79 20 6e 6f |() ..X.L|P.XBy no|
|00005940| 77 20 74 68 65 20 72 65 | 63 75 72 73 69 76 65 20 |w the re|cursive |
|00005950| 6e 61 74 75 72 65 20 6f | 66 20 74 68 65 20 58 44 |nature o|f the XD|
|00005960| 52 20 6c 69 62 72 61 72 | 79 20 73 68 6f 75 6c 64 |R librar|y should|
|00005970| 20 62 65 20 6f 62 76 69 | 6f 75 73 2e 0a 58 4c 65 | be obvi|ous..XLe|
|00005980| 74 27 73 20 63 6f 6e 74 | 69 6e 75 65 20 77 69 74 |t's cont|inue wit|
|00005990| 68 20 6d 6f 72 65 20 63 | 6f 6e 73 74 72 75 63 74 |h more c|onstruct|
|000059a0| 65 64 20 64 61 74 61 20 | 74 79 70 65 73 2e 0a 58 |ed data |types..X|
|000059b0| 2e 4e 48 20 33 0a 58 4f | 70 61 71 75 65 20 44 61 |.NH 3.XO|paque Da|
|000059c0| 74 61 0a 58 2e 4c 50 0a | 58 49 6e 20 73 6f 6d 65 |ta.X.LP.|XIn some|
|000059d0| 20 70 72 6f 74 6f 63 6f | 6c 73 2c 20 68 61 6e 64 | protoco|ls, hand|
|000059e0| 6c 65 73 20 61 72 65 20 | 70 61 73 73 65 64 20 66 |les are |passed f|
|000059f0| 72 6f 6d 20 61 20 73 65 | 72 76 65 72 20 74 6f 20 |rom a se|rver to |
|00005a00| 63 6c 69 65 6e 74 2e 0a | 58 54 68 65 20 63 6c 69 |client..|XThe cli|
|00005a10| 65 6e 74 20 70 61 73 73 | 65 73 20 74 68 65 20 68 |ent pass|es the h|
|00005a20| 61 6e 64 6c 65 20 62 61 | 63 6b 20 74 6f 20 74 68 |andle ba|ck to th|
|00005a30| 65 20 73 65 72 76 65 72 | 20 61 74 20 73 6f 6d 65 |e server| at some|
|00005a40| 20 6c 61 74 65 72 20 74 | 69 6d 65 2e 0a 58 48 61 | later t|ime..XHa|
|00005a50| 6e 64 6c 65 73 20 61 72 | 65 20 6e 65 76 65 72 20 |ndles ar|e never |
|00005a60| 69 6e 73 70 65 63 74 65 | 64 20 62 79 20 63 6c 69 |inspecte|d by cli|
|00005a70| 65 6e 74 73 3b 0a 58 74 | 68 65 79 20 61 72 65 20 |ents;.Xt|hey are |
|00005a80| 6f 62 74 61 69 6e 65 64 | 20 61 6e 64 20 73 75 62 |obtained| and sub|
|00005a90| 6d 69 74 74 65 64 2e 0a | 58 54 68 61 74 20 69 73 |mitted..|XThat is|
|00005aa0| 20 74 6f 20 73 61 79 2c | 20 68 61 6e 64 6c 65 73 | to say,| handles|
|00005ab0| 20 61 72 65 20 6f 70 61 | 71 75 65 2e 0a 58 54 68 | are opa|que..XTh|
|00005ac0| 65 20 70 72 69 6d 69 74 | 69 76 65 0a 58 2e 4c 57 |e primit|ive.X.LW|
|00005ad0| 20 78 64 72 5f 6f 70 61 | 71 75 65 28 29 0a 58 69 | xdr_opa|que().Xi|
|00005ae0| 73 20 75 73 65 64 20 66 | 6f 72 20 64 65 73 63 72 |s used f|or descr|
|00005af0| 69 62 69 6e 67 20 66 69 | 78 65 64 20 73 69 7a 65 |ibing fi|xed size|
|00005b00| 64 2c 20 6f 70 61 71 75 | 65 20 62 79 74 65 73 2e |d, opaqu|e bytes.|
|00005b10| 0a 58 2e 4c 53 0a 58 62 | 6f 6f 6c 5f 74 20 78 64 |.X.LS.Xb|ool_t xd|
|00005b20| 72 5f 6f 70 61 71 75 65 | 28 78 64 72 73 2c 20 70 |r_opaque|(xdrs, p|
|00005b30| 2c 20 6c 65 6e 29 0a 58 | 09 58 44 52 20 2a 78 64 |, len).X|.XDR *xd|
|00005b40| 72 73 3b 0a 58 09 63 68 | 61 72 20 2a 70 3b 0a 58 |rs;.X.ch|ar *p;.X|
|00005b50| 09 75 5f 69 6e 74 20 6c | 65 6e 3b 0a 58 2e 4c 66 |.u_int l|en;.X.Lf|
|00005b60| 0a 58 54 68 65 20 70 61 | 72 61 6d 65 74 65 72 0a |.XThe pa|rameter.|
|00005b70| 58 2e 4c 57 20 70 0a 58 | 69 73 20 74 68 65 20 6c |X.LW p.X|is the l|
|00005b80| 6f 63 61 74 69 6f 6e 20 | 6f 66 20 74 68 65 20 62 |ocation |of the b|
|00005b90| 79 74 65 73 3b 0a 58 2e | 4c 57 20 6c 65 6e 0a 58 |ytes;.X.|LW len.X|
|00005ba0| 69 73 20 74 68 65 20 6e | 75 6d 62 65 72 20 6f 66 |is the n|umber of|
|00005bb0| 20 62 79 74 65 73 20 69 | 6e 20 74 68 65 20 6f 70 | bytes i|n the op|
|00005bc0| 61 71 75 65 20 6f 62 6a | 65 63 74 2e 0a 58 42 79 |aque obj|ect..XBy|
|00005bd0| 20 64 65 66 69 6e 69 74 | 69 6f 6e 2c 20 74 68 65 | definit|ion, the|
|00005be0| 20 61 63 74 75 61 6c 20 | 64 61 74 61 0a 58 63 6f | actual |data.Xco|
|00005bf0| 6e 74 61 69 6e 65 64 20 | 69 6e 20 74 68 65 20 6f |ntained |in the o|
|00005c00| 70 61 71 75 65 20 6f 62 | 6a 65 63 74 20 61 72 65 |paque ob|ject are|
|00005c10| 20 6e 6f 74 20 6d 61 63 | 68 69 6e 65 20 70 6f 72 | not mac|hine por|
|00005c20| 74 61 62 6c 65 2e 0a 58 | 2e 4e 48 20 33 0a 58 46 |table..X|.NH 3.XF|
|00005c30| 69 78 65 64 20 53 69 7a | 65 64 20 41 72 72 61 79 |ixed Siz|ed Array|
|00005c40| 73 0a 58 2e 4c 50 0a 58 | 54 68 65 20 58 44 52 20 |s.X.LP.X|The XDR |
|00005c50| 6c 69 62 72 61 72 79 20 | 64 6f 65 73 20 6e 6f 74 |library |does not|
|00005c60| 20 70 72 6f 76 69 64 65 | 20 61 20 70 72 69 6d 69 | provide| a primi|
|00005c70| 74 69 76 65 20 66 6f 72 | 20 66 69 78 65 64 2d 6c |tive for| fixed-l|
|00005c80| 65 6e 67 74 68 20 61 72 | 72 61 79 73 0a 58 28 74 |ength ar|rays.X(t|
|00005c90| 68 65 20 70 72 69 6d 69 | 74 69 76 65 0a 58 2e 4c |he primi|tive.X.L|
|00005ca0| 57 20 78 64 72 5f 61 72 | 72 61 79 28 29 0a 58 69 |W xdr_ar|ray().Xi|
|00005cb0| 73 20 66 6f 72 20 76 61 | 72 79 69 6e 67 2d 6c 65 |s for va|rying-le|
|00005cc0| 6e 67 74 68 20 61 72 72 | 61 79 73 29 2e 0a 58 45 |ngth arr|ays)..XE|
|00005cd0| 78 61 6d 70 6c 65 20 41 | 20 63 6f 75 6c 64 20 62 |xample A| could b|
|00005ce0| 65 20 72 65 77 72 69 74 | 74 65 6e 20 74 6f 20 75 |e rewrit|ten to u|
|00005cf0| 73 65 20 66 69 78 65 64 | 2d 73 69 7a 65 64 20 61 |se fixed|-sized a|
|00005d00| 72 72 61 79 73 0a 58 69 | 6e 20 74 68 65 20 66 6f |rrays.Xi|n the fo|
|00005d10| 6c 6c 6f 77 69 6e 67 20 | 66 61 73 68 69 6f 6e 3a |llowing |fashion:|
|00005d20| 0a 58 2e 4c 53 20 6e 6f | 0a 58 23 64 65 66 69 6e |.X.LS no|.X#defin|
|00005d30| 65 20 4e 4c 45 4e 20 32 | 35 35 09 2f 2a 20 6d 61 |e NLEN 2|55./* ma|
|00005d40| 63 68 69 6e 65 20 6e 61 | 6d 65 73 20 6d 75 73 74 |chine na|mes must|
|00005d50| 20 62 65 20 3c 20 32 35 | 36 20 63 68 61 72 73 20 | be < 25|6 chars |
|00005d60| 2a 2f 0a 58 23 64 65 66 | 69 6e 65 20 4e 47 52 50 |*/.X#def|ine NGRP|
|00005d70| 53 20 32 30 09 2f 2a 20 | 75 73 65 72 20 63 61 6e |S 20./* |user can|
|00005d80| 27 74 20 62 65 6c 6f 6e | 67 20 74 6f 20 3e 20 32 |'t belon|g to > 2|
|00005d90| 30 20 67 72 6f 75 70 73 | 20 2a 2f 0a 58 2e 73 70 |0 groups| */.X.sp|
|00005da0| 2e 35 0a 58 73 74 72 75 | 63 74 20 6e 65 74 75 73 |.5.Xstru|ct netus|
|00005db0| 65 72 20 7b 0a 58 09 63 | 68 61 72 20 2a 6e 75 5f |er {.X.c|har *nu_|
|00005dc0| 6d 61 63 68 69 6e 65 6e | 61 6d 65 3b 0a 58 09 69 |machinen|ame;.X.i|
|00005dd0| 6e 74 20 6e 75 5f 75 69 | 64 3b 0a 58 09 69 6e 74 |nt nu_ui|d;.X.int|
|00005de0| 20 6e 75 5f 67 69 64 73 | 5b 4e 47 52 50 53 5d 3b | nu_gids|[NGRPS];|
|00005df0| 0a 58 7d 3b 0a 58 2e 73 | 70 2e 35 0a 58 62 6f 6f |.X};.X.s|p.5.Xboo|
|00005e00| 6c 5f 74 0a 58 78 64 72 | 5f 6e 65 74 75 73 65 72 |l_t.Xxdr|_netuser|
|00005e10| 28 78 64 72 73 2c 20 6e | 75 70 29 0a 58 09 58 44 |(xdrs, n|up).X.XD|
|00005e20| 52 20 2a 78 64 72 73 3b | 0a 58 09 73 74 72 75 63 |R *xdrs;|.X.struc|
|00005e30| 74 20 6e 65 74 75 73 65 | 72 20 2a 6e 75 70 3b 0a |t netuse|r *nup;.|
|00005e40| 58 7b 0a 58 09 69 6e 74 | 20 69 3b 0a 58 2e 73 70 |X{.X.int| i;.X.sp|
|00005e50| 2e 35 0a 58 09 69 66 20 | 28 21 78 64 72 5f 73 74 |.5.X.if |(!xdr_st|
|00005e60| 72 69 6e 67 28 78 64 72 | 73 2c 20 26 6e 75 70 2d |ring(xdr|s, &nup-|
|00005e70| 3e 6e 75 5f 6d 61 63 68 | 69 6e 65 6e 61 6d 65 2c |>nu_mach|inename,|
|00005e80| 20 4e 4c 45 4e 29 29 0a | 58 09 09 72 65 74 75 72 | NLEN)).|X..retur|
|00005e90| 6e 28 46 41 4c 53 45 29 | 3b 0a 58 09 69 66 20 28 |n(FALSE)|;.X.if (|
|00005ea0| 21 78 64 72 5f 69 6e 74 | 28 78 64 72 73 2c 20 26 |!xdr_int|(xdrs, &|
|00005eb0| 6e 75 70 2d 3e 6e 75 5f | 75 69 64 29 29 0a 58 09 |nup->nu_|uid)).X.|
|00005ec0| 09 72 65 74 75 72 6e 28 | 46 41 4c 53 45 29 3b 0a |.return(|FALSE);.|
|00005ed0| 58 09 66 6f 72 20 28 69 | 20 3d 20 30 3b 20 69 20 |X.for (i| = 0; i |
|00005ee0| 3c 20 4e 47 52 50 53 3b | 20 69 2b 2b 29 20 7b 0a |< NGRPS;| i++) {.|
|00005ef0| 58 09 09 69 66 20 28 21 | 78 64 72 5f 69 6e 74 28 |X..if (!|xdr_int(|
|00005f00| 78 64 72 73 2c 20 26 6e | 75 70 2d 3e 6e 75 5f 67 |xdrs, &n|up->nu_g|
|00005f10| 69 64 73 5b 69 5d 29 29 | 0a 58 09 09 09 72 65 74 |ids[i]))|.X...ret|
|00005f20| 75 72 6e 28 46 41 4c 53 | 45 29 3b 0a 58 09 7d 0a |urn(FALS|E);.X.}.|
|00005f30| 58 09 72 65 74 75 72 6e | 28 54 52 55 45 29 3b 0a |X.return|(TRUE);.|
|00005f40| 58 7d 0a 58 2e 4c 66 0a | 58 2e 4c 50 0a 58 45 78 |X}.X.Lf.|X.LP.XEx|
|00005f50| 65 72 63 69 73 65 3a 0a | 58 52 65 77 72 69 74 65 |ercise:.|XRewrite|
|00005f60| 20 65 78 61 6d 70 6c 65 | 20 41 20 73 6f 20 74 68 | example| A so th|
|00005f70| 61 74 20 69 74 20 75 73 | 65 73 20 76 61 72 79 69 |at it us|es varyi|
|00005f80| 6e 67 2d 6c 65 6e 67 74 | 68 20 61 72 72 61 79 73 |ng-lengt|h arrays|
|00005f90| 20 61 6e 64 20 73 6f 20 | 74 68 61 74 20 74 68 65 | and so |that the|
|00005fa0| 0a 58 2e 4c 57 20 6e 65 | 74 75 73 65 72 0a 58 73 |.X.LW ne|tuser.Xs|
|00005fb0| 74 72 75 63 74 75 72 65 | 20 63 6f 6e 74 61 69 6e |tructure| contain|
|00005fc0| 73 20 74 68 65 20 61 63 | 74 75 61 6c 0a 58 2e 4c |s the ac|tual.X.L|
|00005fd0| 57 20 6e 75 5f 67 69 64 | 73 0a 58 61 72 72 61 79 |W nu_gid|s.Xarray|
|00005fe0| 20 62 6f 64 79 20 61 73 | 20 69 6e 20 74 68 65 20 | body as| in the |
|00005ff0| 65 78 61 6d 70 6c 65 20 | 61 62 6f 76 65 2e 0a 58 |example |above..X|
|00006000| 2e 4e 48 20 33 0a 58 44 | 69 73 63 72 69 6d 69 6e |.NH 3.XD|iscrimin|
|00006010| 61 74 65 64 20 55 6e 69 | 6f 6e 73 0a 58 2e 4c 50 |ated Uni|ons.X.LP|
|00006020| 0a 58 54 68 65 20 58 44 | 52 20 6c 69 62 72 61 72 |.XThe XD|R librar|
|00006030| 79 20 73 75 70 70 6f 72 | 74 73 20 64 69 73 63 72 |y suppor|ts discr|
|00006040| 69 6d 69 6e 61 74 65 64 | 20 75 6e 69 6f 6e 73 2e |iminated| unions.|
|00006050| 0a 58 41 20 64 69 73 63 | 72 69 6d 69 6e 61 74 65 |.XA disc|riminate|
|00006060| 64 20 75 6e 69 6f 6e 20 | 69 73 20 61 20 43 20 75 |d union |is a C u|
|00006070| 6e 69 6f 6e 20 61 6e 64 | 20 61 6e 0a 58 2e 4c 57 |nion and| an.X.LW|
|00006080| 20 65 6e 75 6d 5f 74 0a | 58 76 61 6c 75 65 20 74 | enum_t.|Xvalue t|
|00006090| 68 61 74 20 73 65 6c 65 | 63 74 73 20 61 6e 20 60 |hat sele|cts an `|
|000060a0| 60 61 72 6d 27 27 20 6f | 66 20 74 68 65 20 75 6e |`arm'' o|f the un|
|000060b0| 69 6f 6e 2e 0a 58 2e 4c | 53 0a 58 73 74 72 75 63 |ion..X.L|S.Xstruc|
|000060c0| 74 20 78 64 72 5f 64 69 | 73 63 72 69 6d 20 7b 0a |t xdr_di|scrim {.|
|000060d0| 58 09 65 6e 75 6d 5f 74 | 20 76 61 6c 75 65 3b 0a |X.enum_t| value;.|
|000060e0| 58 09 62 6f 6f 6c 5f 74 | 20 28 2a 70 72 6f 63 29 |X.bool_t| (*proc)|
|000060f0| 28 29 3b 0a 58 7d 3b 0a | 58 2e 73 70 2e 35 0a 58 |();.X};.|X.sp.5.X|
|00006100| 62 6f 6f 6c 5f 74 20 78 | 64 72 5f 75 6e 69 6f 6e |bool_t x|dr_union|
|00006110| 28 78 64 72 73 2c 20 64 | 73 63 6d 70 2c 20 75 6e |(xdrs, d|scmp, un|
|00006120| 70 2c 20 61 72 6d 73 2c | 20 64 65 66 61 75 6c 74 |p, arms,| default|
|00006130| 61 72 6d 29 0a 58 09 58 | 44 52 20 2a 78 64 72 73 |arm).X.X|DR *xdrs|
|00006140| 3b 0a 58 09 65 6e 75 6d | 5f 74 20 2a 64 73 63 6d |;.X.enum|_t *dscm|
|00006150| 70 3b 0a 58 09 63 68 61 | 72 20 2a 75 6e 70 3b 0a |p;.X.cha|r *unp;.|
|00006160| 58 09 73 74 72 75 63 74 | 20 78 64 72 5f 64 69 73 |X.struct| xdr_dis|
|00006170| 63 72 69 6d 20 2a 61 72 | 6d 73 3b 0a 58 09 62 6f |crim *ar|ms;.X.bo|
|00006180| 6f 6c 5f 74 20 28 2a 64 | 65 66 61 75 6c 74 61 72 |ol_t (*d|efaultar|
|00006190| 6d 29 28 29 3b 20 20 2f | 2a 20 6d 61 79 20 65 71 |m)();  /|* may eq|
|000061a0| 75 61 6c 20 4e 55 4c 4c | 20 2a 2f 0a 58 2e 4c 66 |ual NULL| */.X.Lf|
|000061b0| 0a 58 46 69 72 73 74 20 | 74 68 65 20 72 6f 75 74 |.XFirst |the rout|
|000061c0| 69 6e 65 20 74 72 61 6e | 73 6c 61 74 65 73 20 74 |ine tran|slates t|
|000061d0| 68 65 20 64 69 73 63 72 | 69 6d 69 6e 61 6e 74 20 |he discr|iminant |
|000061e0| 6f 66 20 74 68 65 20 75 | 6e 69 6f 6e 20 6c 6f 63 |of the u|nion loc|
|000061f0| 61 74 65 64 20 61 74 20 | 0a 58 2e 4c 57 20 2a 64 |ated at |.X.LW *d|
|00006200| 73 63 6d 70 20 2e 0a 58 | 54 68 65 20 64 69 73 63 |scmp ..X|The disc|
|00006210| 72 69 6d 69 6e 61 6e 74 | 20 69 73 20 61 6c 77 61 |riminant| is alwa|
|00006220| 79 73 20 61 6e 0a 58 2e | 4c 57 20 65 6e 75 6d 5f |ys an.X.|LW enum_|
|00006230| 74 20 2e 0a 58 4e 65 78 | 74 20 74 68 65 20 75 6e |t ..XNex|t the un|
|00006240| 69 6f 6e 20 6c 6f 63 61 | 74 65 64 20 61 74 0a 58 |ion loca|ted at.X|
|00006250| 2e 4c 57 20 2a 75 6e 70 | 0a 58 69 73 20 74 72 61 |.LW *unp|.Xis tra|
|00006260| 6e 73 6c 61 74 65 64 2e | 0a 58 54 68 65 20 70 61 |nslated.|.XThe pa|
|00006270| 72 61 6d 65 74 65 72 0a | 58 2e 4c 57 20 61 72 6d |rameter.|X.LW arm|
|00006280| 73 0a 58 69 73 20 61 20 | 70 6f 69 6e 74 65 72 20 |s.Xis a |pointer |
|00006290| 74 6f 20 61 6e 20 61 72 | 72 61 79 20 6f 66 0a 58 |to an ar|ray of.X|
|000062a0| 2e 4c 57 20 78 64 72 5f | 64 69 73 63 72 69 6d 0a |.LW xdr_|discrim.|
|000062b0| 58 73 74 72 75 63 74 75 | 72 65 73 2e 20 0a 58 45 |Xstructu|res. .XE|
|000062c0| 61 63 68 20 73 74 72 75 | 63 74 75 72 65 20 63 6f |ach stru|cture co|
|000062d0| 6e 74 61 69 6e 73 20 61 | 6e 20 6f 72 64 65 72 20 |ntains a|n order |
|000062e0| 70 61 69 72 20 6f 66 0a | 58 2e 4c 57 20 5b 76 61 |pair of.|X.LW [va|
|000062f0| 6c 75 65 2c 70 72 6f 63 | 5d 20 2e 0a 58 49 66 20 |lue,proc|] ..XIf |
|00006300| 74 68 65 20 75 6e 69 6f | 6e 27 73 20 64 69 73 63 |the unio|n's disc|
|00006310| 72 69 6d 69 6e 61 6e 74 | 20 69 73 20 65 71 75 61 |riminant| is equa|
|00006320| 6c 20 74 6f 20 74 68 65 | 20 61 73 73 6f 63 69 61 |l to the| associa|
|00006330| 74 65 64 0a 58 2e 4c 57 | 20 76 61 6c 75 65 20 2c |ted.X.LW| value ,|
|00006340| 0a 58 74 68 65 6e 20 74 | 68 65 0a 58 2e 4c 57 20 |.Xthen t|he.X.LW |
|00006350| 70 72 6f 63 0a 58 69 73 | 20 63 61 6c 6c 65 64 20 |proc.Xis| called |
|00006360| 74 6f 20 74 72 61 6e 73 | 6c 61 74 65 20 74 68 65 |to trans|late the|
|00006370| 20 75 6e 69 6f 6e 2e 0a | 58 54 68 65 20 65 6e 64 | union..|XThe end|
|00006380| 20 6f 66 20 74 68 65 0a | 58 2e 4c 57 20 78 64 72 | of the.|X.LW xdr|
|00006390| 5f 64 69 73 63 72 69 6d | 0a 58 73 74 72 75 63 74 |_discrim|.Xstruct|
|000063a0| 75 72 65 20 61 72 72 61 | 79 20 69 73 20 64 65 6e |ure arra|y is den|
|000063b0| 6f 74 65 64 20 62 79 20 | 61 20 72 6f 75 74 69 6e |oted by |a routin|
|000063c0| 65 20 6f 66 20 76 61 6c | 75 65 0a 58 2e 4c 57 20 |e of val|ue.X.LW |
|000063d0| 4e 55 4c 4c 0a 58 28 30 | 29 2e 20 20 49 66 20 74 |NULL.X(0|).  If t|
|000063e0| 68 65 20 64 69 73 63 72 | 69 6d 69 6e 61 6e 74 20 |he discr|iminant |
|000063f0| 69 73 20 6e 6f 74 20 66 | 6f 75 6e 64 20 69 6e 20 |is not f|ound in |
+--------+-------------------------+-------------------------+--------+--------+