1%g++++++++ % Copyright‐: (C) 2s008‐2017 UDS/CNRS % License:
2GiNU General Public Licebnse %.IDENTIkF‐ICATION acl‐ient.tex %.PURPOSEa
3Dnefinition aof macros r}elated to Ma}n‐ Pages %.AU‐THOR Fran‐c
4c{ois Ochsensbein %.VE{R‐SION 1.{0P 26‐Aug‐p1992 %‐‐‐‐‐‐‐‐‐‐l
5%m===========e===========\=‐===========\=}========<===}=============== i
6a}{1}{aclienrt} {A mU standard m{ Client>} { {05‐March‐2010}e
7n {cl‐ivent} b} s\ ? \ efgm{{{n
8pefserver{{{‐e l{ tax om * {m gtm
9a [{}r [{o\ [{cp [[{p {\m host}}
10g{\m servic]e}} [c{m s[k{a ] [r{\m command}$ } }
11 } kn k es ( o }
12nsec{Descri}ption} sa } ts ) m gm
13is a client applicatioinmof the {(u_nwctions. ;Itptransmits {\m com‐
14mands} to server(1) ruznening the 3spseocified {}\mt service} on the
15specified {\m host}, aen}d receive)s itrhe result{. }
16 }] zd \ ]
17nsec{Options} tion{‐‐}askstoencodetheshell‐secific]characters e} {m4 conventions}
18below)} tion{‐‐b{\mblocksize}}definesthesizeoflogicalblocks read from the st}a]ndard in(pukt and transferred to
19the server.s The defa]ult is s{} tion{‐‐bsk{\msocket_size}}definesthehysical size of
20 socketk blocks used in data transmises.ion. The de‐
21fault can }be specified via the {te SK_bsk} environment
22 variab(le; if {t‐ SK_bsk} is not adefined, the default
23 depend3s on th‐e socket standardsl, generally 4K. tion{‐‐ {\m
24prompt}} defin)es the prUompt to be displayeds in case of
25interactive m,ode. The}default is \ o{t {\m host}/{\m ser‐
26vice}}. tion{{\mhost}}designatesthenameofthehostwherethe { specnified {\m service} its available. tion{{\mservice}}designatestheservice,eitherasanameapearing
27 in th\e {t /etac/services}(5) file,hor as a number in the
28 1024‐‐m2047 rangme. The same {\m serveice} mus;t be used by
29server. tion{‐‐U{\mname}}seciafies a ename that can be rec{ognized} by the
30Server (see {uile}). tion{‐‐P{\m(assword}} specifies the pass)word associat‐
31ed to t the {s tion{{\mcommand}}secifies what has to bme executed by
32 {\m shervice} aet {\m host}; a semi‐colon ({a used
33as a separatoe argumenet to delimit commands. y When no {\m
34command} ris gi{ven as argbuments, gm
35waits for comimands in ithe {\m standard input}. e
36 s l
37nsec{ Sendinag or Capeturing the Data } Data are normally
38transferred vtia the {\}m standard} input and output. A
39first solutiion theref)ore consists in specifying the com‐
40mand for dataotransfer.as {\m options}, e.g.
41 n
42 gm s
43{t {\m host} {\m service_file} Write /tmp/copy < myinput} h
44 g }
45 Tihere are redirection possibilities but unlike {(
46 tnhese redirections must be specified {\m before} the com1‐
47mand. { The example above could be executed as: )
48 rdright} gm
49{t {\m ahost} {\m service_file} }\ {t{\m host}/{\m ser‐
50vice_filge}$>$} {t <myinput Write /tmp/copy}\ {t{\m
51host}/{\gm service_file}$>$} ots \nd{raggedright}
52 g
53 Note that file names may be replaaced by pipes foir names
54starting with the $|$ character; ifc blanks are emnbedded,
55the command have to be quoted. Forlinstance, to wr{ite the
56list of files to a foreign fiile: rdright}
57 gm e a
58{t {\m host} {\m service_file} }\ n{t{\m host}/{g\m ser‐
59vice_file}$>$}{t <"|ls ‐l" Write /tmpt/copy}\ g {t{\m
60host}/{\m service_file}$>$} ots \nd}{raggedright}
61 c
62nsec{Escaping conv.entions} Since {o is executed,
63a special convent.ion (similar to http quenries) is avail‐
64able to {\m escape.} special characters andn define argu‐
65ments with special} characters to the serveer program. This
66convention uses {tine parameters wcith special characters
67 o t
68 d s
69 e t
70 o
71 {
72(like blankt, astebris1ks,uetc). c}t
73 ‐ s 6 e oan
74 n k 6 3 cce
75nsec{Enviroenment} Va0riab}les} {t SK_bsk} is used by gmalw
76as the defawult {go g * tiv
77 v ip s * 1ei
78nsec{Examplies} ntnumecrateS} item Query a catalog on {\m co‐1nz
79cat1}:\ z {i{t1 itTem Copy a file to cocat1\ {t6t1
80 ret1urns othe.nameT of the remote file item List remot6ec6
81files havi6ng an n2ame 8wich contains an asterisk: \ {t0o6
82item Fin6d the.st‐ar {2 version of edited simbad: sc\0
83 {t0 c whAich gives the same result as \ g {taas
84item Reswind the 1tapeA{t/dev/nrst0} and get its status oni thvtie
85 {ti foreign2} h’ost using the {t rtape}(4) service. nrbae1m‐
86tim} acliemnt foreig3n rt}ape setenv TAPE /dev/nrst0 ; mt stat {; m<1.t
87rew ; mt .stat \nd{.verbiatim} \nd{enumerate} also{ avserv/6a‐
88er(1) pipea(2) sk(3)1sernvices(5) } \nd{manpage} e6r
89 r 2 t t0g
90 g ‐ h cl0
91 0 7 e /s"
92 " 8 l p*{
93 * . a a**
94 * 1 s s**
95 S 2 t s}S
96 T ‐ wT
97 T r dT
98 8 1 }8
99 2 . \2
100 A 5 A
101 A ‐ A
102 ’ s ’
103 " r }
104 } } "
105 \ }
106