From 9ecf0b0bc16566c9d1b19c0b9a7c3cb9e1e8da4b Mon Sep 17 00:00:00 2001 From: Julien BLACHE Date: Sat, 3 May 2008 17:08:30 +0000 Subject: [PATCH] Replace occurrences of SANE_STATUS_SUCCESS with SANE_STATUS_GOOD. --- html/doc017.html | 12 +-- sane.ps | 245 ++++++++++++++++++++++++----------------------- 2 files changed, 130 insertions(+), 127 deletions(-) diff --git a/html/doc017.html b/html/doc017.html index 1e3a5c73..f1aa16f8 100644 --- a/html/doc017.html +++ b/html/doc017.html @@ -62,7 +62,7 @@ to the user. E.g., it could be used as the default-user name in subsequent authentication calls.

In the reply, status indicates the completion status. If the -value is anything other than SANE_STATUS_SUCCESS, the +value is anything other than SANE_STATUS_GOOD, the remainder of the reply has undefined values.2 The version_code argument returns the SANE version-code that the network daemon supports. See the comments in the previous paragraph on the meaning of the build-revision in this @@ -96,7 +96,7 @@ daemon. There are no arguments in the request for this call.

In the reply, status indicates the completion status. If the -value is anything other than SANE_STATUS_SUCCESS, the +value is anything other than SANE_STATUS_GOOD, the remainder of the reply has undefined values. The device_list argument is a pointer to a NULL-terminated array of SANE_Device pointers. @@ -133,7 +133,7 @@ The device_name argument specifies the name of the device to open.

In the reply, status indicates the completion status. If the -value is anything other than SANE_STATUS_SUCCESS, the +value is anything other than SANE_STATUS_GOOD, the remainder of the reply has undefined values. The handle argument specifies the device handle that uniquely identifies the connection. The resource argument is used to request @@ -270,7 +270,7 @@ this value is non-NULL, all other arguments have undefined values (see Section 5.2.10 for details on how to authorize a resource). Argument status indicates the completion status. If the value is anything other than -SANE_STATUS_SUCCESS, the remainder of the reply has undefined +SANE_STATUS_GOOD, the remainder of the reply has undefined values. The info argument returns the information on how well the backend was able to satisfy the request. For details, see the description of the corresponding argument in @@ -311,7 +311,7 @@ The handle argument identifies the connection to the remote device whose scan parameters should be returned.

In the reply, status indicates the completion status. If the -value is anything other than SANE_STATUS_SUCCESS, the +value is anything other than SANE_STATUS_GOOD, the remainder of the reply has undefined values. The argument params is used to return the scan parameters. @@ -356,7 +356,7 @@ this value is non-NULL, all other arguments have undefined values (see Section 5.2.10 for details on how to authorize a resource). Argument, status indicates the completion status. If the value is anything other than -SANE_STATUS_SUCCESS, the remainder of the reply has +SANE_STATUS_GOOD, the remainder of the reply has undefined values. The argument port returns the port number from which the image data will be available. To read the image data, a network client must connect to the remote host at the indicated port diff --git a/sane.ps b/sane.ps index e57ef864..2e759b78 100644 --- a/sane.ps +++ b/sane.ps @@ -1,9 +1,10 @@ %!PS-Adobe-2.0 -%%Creator: dvips(k) 5.95a Copyright 2005 Radical Eye Software +%%Creator: dvips(k) 5.96.1 Copyright 2007 Radical Eye Software %%Title: sane.dvi +%%CreationDate: Sat May 3 19:06:10 2008 %%Pages: 47 %%PageOrder: Ascend -%%BoundingBox: 0 0 595 842 +%%BoundingBox: 0 0 596 842 %%DocumentFonts: Times-Roman Times-Bold Courier Times-Italic CMSY10 %%+ CMR10 CMR8 CMMI10 CMTT10 CMEX10 Times-BoldItalic %%DocumentPaperSizes: a4 @@ -11,7 +12,7 @@ %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: /usr/bin/dvips sane.dvi -o sane.ps %DVIPSParameters: dpi=600 -%DVIPSSource: TeX output 2006.01.03:1427 +%DVIPSSource: TeX output 2008.05.03:1906 %%BeginProcSet: tex.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -65,7 +66,7 @@ rmoveto}B/y{3 2 roll p a}B/bos{/SS save N}B/eos{SS restore}B end % author = "S. Rahtz, P. MacKay, Alan Jeffrey, B. Horn, K. Berry, % W. Schmidt, P. Lehman", % version = "2.0", -% date = "30 October 2002", +% date = "27nov06", % filename = "8r.enc", % email = "tex-fonts@@tug.org", % docstring = "This is the encoding vector for Type1 and TrueType @@ -175,7 +176,7 @@ rmoveto}B/y{3 2 roll p a}B/bos{/SS save N}B/eos{SS restore}B end /currency /yen /brokenbar /section /dieresis /copyright /ordfeminine /guillemotleft /logicalnot /hyphen /registered /macron -% 0xD0 +% 0xB0 /degree /plusminus /twosuperior /threesuperior /acute /mu /paragraph /periodcentered /cedilla /onesuperior /ordmasculine /guillemotright @@ -972,7 +973,7 @@ B2BDCBE463EFBDAE0C19CF14D906BFEE7E13E727869127A61632CC57E3ABAF 0000000000000000000000000000000000000000000000000000000000000000 cleartomark %%EndFont -TeXDict begin 39139632 55387786 1000 600 600 (sane.dvi) +TeXDict begin 39158280 55380996 1000 600 600 (sane.dvi) @start /Fa 134[40 3[51 25 35 35 1[45 45 51 71 3[25 3[40 1[40 1[45 97[{TeXBase1Encoding ReEncodeFont}13 90.9091 /Times-BoldItalic rf /Fb 215[67 40[{}1 83.022 /CMEX10 @@ -1025,22 +1026,27 @@ rf /Fr 133[40 45 1[66 45 51 30 35 40 51 51 45 51 76 25 92 1[115 103 115 172 57 115 1[57 115 103 69 92 115 92 115 103 12[138 115 2[126 1[149 1[138 2[80 2[126 138 1[149 1[149 23[69 69 40[{TeXBase1Encoding ReEncodeFont}34 206.559 -/Times-Bold rf /Ft 201[50 2[50 50 50 50 2[33 45[{ -TeXBase1Encoding ReEncodeFont}6 99.6264 /Times-Roman +/Times-Bold rf /Ft 201[50 1[50 1[50 1[50 2[33 45[{ +TeXBase1Encoding ReEncodeFont}5 99.6264 /Times-Roman rf /Fu 139[48 67 57 2[86 86 4[48 3[76 86 2[76 10[124 -2[96 4[124 8[105 3[124 12[86 2[86 86 1[43 46[{ +2[96 4[124 8[105 3[124 11[86 3[86 86 1[43 46[{ TeXBase1Encoding ReEncodeFont}18 172.188 /Times-Roman rf end %%EndProlog %%BeginSetup %%Feature: *Resolution 600dpi TeXDict begin -%%PaperSize: A4 +%%BeginPaperSize: a4 +/setpagedevice where +{ pop << /PageSize [595 842] >> setpagedevice } +{ /a4 where { pop a4 } if } +ifelse +%%EndPaperSize end %%EndSetup %%Page: 1 1 TeXDict begin 1 0 bop 941 1939 a Fu(SANE)44 b(Standard)g(V)-19 -b(ersion)44 b(1.04)1718 2698 y Ft(2006-01-03)p eop end +b(ersion)44 b(1.05)1718 2698 y Ft(2006-04-02)p eop end %%Page: 1 2 TeXDict begin 1 1 bop 0 845 a Fs(Contents)0 1439 y Fr(1)91 b(Pr)n(eface)3430 b(6)136 1610 y Fq(1.1)96 b(About)24 @@ -1464,11 +1470,9 @@ b(connection:)43 b Fq(Ar)n(guably)32 b(the)e(ultimate)h(w)o(ay)f(to)g (there)g(is)f(a)g(netw)o(ork)h(connection)j(to)c(that)h(host)g(and)g (pro)o(vided)h(the)e(user)h(is)g(permitted)227 2191 y(to)d(access)h (that)f(scanner)-5 b(.)0 2479 y - currentpoint currentpoint translate 0.64821 0.64821 scale neg exch -neg exch translate + currentpoint currentpoint translate 0.64821 0.64821 scale neg exch neg exch translate 0 2479 a 0 2479 a - gsave currentpoint currentpoint translate 270 neg rotate neg exch -neg exch translate + gsave currentpoint currentpoint translate 270 neg rotate neg exch neg exch translate 0 2479 a @beginspecial 0 @llx 0 @lly 355 @urx 722 @ury 3550 @rwi @setspecial @@ -1687,8 +1691,7 @@ rs @endspecial 2958 2479 a currentpoint grestore moveto 2958 2479 a 0 2479 a - currentpoint currentpoint translate 1 0.64821 div 1 0.64821 div scale -neg exch neg exch translate + currentpoint currentpoint translate 1 0.64821 div 1 0.64821 div scale neg exch neg exch translate 0 2479 a 1267 4550 a Fq(Figure)24 b(3.1:)29 b(Example)24 b(SANE)d(Hiearchy)0 4881 y(The)27 b(abo)o(v)o(e)i(discussion)i(lists)e(just)f(a)f(fe)n(w)h @@ -3259,9 +3262,9 @@ f(returned)h(in)e(a)f(structure)k(of)d(type)g Fp(SANE)p (this)0 1802 y(structure)26 b(is)d(gi)n(v)o(en)h(belo)n(w)-6 b(.)227 2048 y Fp(typedef)52 b(struct)336 2161 y({)445 2274 y(SANE_Frame)e(format;)445 2387 y(SANE_Bool)h(last_frame;)445 -2500 y(SANE_Int)g(lines;)445 2613 y(SANE_Int)g(depth;)445 -2725 y(SANE_Int)g(pixels_per_line;)445 2838 y(SANE_Int)g -(bytes_per_line;)336 2951 y(})227 3064 y(SANE_Parameters)o(;)0 +2500 y(SANE_Int)g(bytes_per_line;)445 2613 y(SANE_Int)g +(pixels_per_line;)445 2725 y(SANE_Int)g(lines;)445 2838 +y(SANE_Int)g(depth;)336 2951 y(})227 3064 y(SANE_Parameters)o(;)0 3310 y Fq(Member)38 b Fp(format)d Fq(speci\002es)k(the)f(format)h(of)f (the)g(ne)o(xt)h(frame)f(to)g(be)g(returned.)74 b(The)38 b(possible)i(v)n(alues)f(for)f(type)0 3423 y Fp(SANE)p @@ -4273,59 +4276,59 @@ b(.)39 b(E.g.,)25 b(it)0 236 y(could)g(be)e(used)i(as)e(the)h(def)o Fq(indicates)37 b(the)f(completion)i(status.)66 b(If)35 b(the)h(v)n(alue)g(is)g(an)o(ything)h(other)g(than)f Fp(SANE)p 3656 407 28 4 v 31 w(STA-)0 520 y(TUS)p 170 -520 V 31 w(SUCCESS)p Fq(,)22 b(the)k(remainder)h(of)f(the)g(reply)g -(has)g(unde\002ned)i(v)n(alues.)2384 487 y Fg(1)2457 -520 y Fq(The)d Fp(version)p 3013 520 V 30 w(code)e Fq(ar)n(gument)28 -b(returns)0 633 y(the)c(SANE)e(v)o(ersion-code)28 b(that)c(the)h(netw)o -(ork)g(daemon)g(supports.)33 b(See)24 b(the)g(comments)i(in)e(the)g -(pre)n(vious)i(paragraph)h(on)0 746 y(the)d(meaning)h(of)e(the)h(b)n -(uild-re)n(vision)k(in)23 b(this)h(v)o(ersion)h(code.)0 -1054 y Fm(5.2.2)99 b Fc(SANE)p 545 1054 30 4 v 35 w(NET)p -760 1054 V 35 w(GET)p 975 1054 V 35 w(DEVICES)0 1287 -y Fq(RPC)22 b(Code:)29 b(1)0 1459 y(This)23 b(RPC)f(is)h(used)i(to)e -(obtain)i(the)f(list)g(of)f(de)n(vices)i(accessible)i(by)c(the)h(SANE)d -(daemon.)1055 1699 y Fr(r)n(equest:)101 b(r)n(eply:)1055 -1812 y Fp(void)196 b(SANE)p 1696 1812 28 4 v 31 w(Word)52 -b(status)1471 1925 y(SANE)p 1696 1925 V 31 w(Device)2103 -1941 y(***)2268 1925 y(device)p 2603 1925 V 29 w(list)0 -2162 y Fq(There)24 b(are)f(no)h(ar)n(guments)i(in)d(the)h(request)h -(for)f(this)g(call.)0 2334 y(In)35 b(the)h(reply)-6 b(,)40 -b Fp(status)32 b Fq(indicates)37 b(the)f(completion)i(status.)66 -b(If)35 b(the)h(v)n(alue)g(is)g(an)o(ything)h(other)g(than)f +520 V 31 w(GOOD)p Fq(,)25 b(the)j(remainder)h(of)e(the)h(reply)h(has)f +(unde\002ned)h(v)n(alues.)2235 487 y Fg(1)2314 520 y +Fq(The)e Fp(version)p 2872 520 V 29 w(code)e Fq(ar)n(gument)30 +b(returns)f(the)0 633 y(SANE)22 b(v)o(ersion-code)27 +b(that)e(the)f(netw)o(ork)i(daemon)f(supports.)33 b(See)24 +b(the)g(comments)h(in)f(the)h(pre)n(vious)h(paragraph)h(on)d(the)0 +746 y(meaning)h(of)e(the)h(b)n(uild-re)n(vision)k(in)23 +b(this)h(v)o(ersion)h(code.)0 1054 y Fm(5.2.2)99 b Fc(SANE)p +545 1054 30 4 v 35 w(NET)p 760 1054 V 35 w(GET)p 975 +1054 V 35 w(DEVICES)0 1287 y Fq(RPC)22 b(Code:)29 b(1)0 +1459 y(This)23 b(RPC)f(is)h(used)i(to)e(obtain)i(the)f(list)g(of)f(de)n +(vices)i(accessible)i(by)c(the)h(SANE)d(daemon.)1055 +1699 y Fr(r)n(equest:)101 b(r)n(eply:)1055 1812 y Fp(void)196 +b(SANE)p 1696 1812 28 4 v 31 w(Word)52 b(status)1471 +1925 y(SANE)p 1696 1925 V 31 w(Device)2103 1941 y(***)2268 +1925 y(device)p 2603 1925 V 29 w(list)0 2162 y Fq(There)24 +b(are)f(no)h(ar)n(guments)i(in)d(the)h(request)h(for)f(this)g(call.)0 +2334 y(In)35 b(the)h(reply)-6 b(,)40 b Fp(status)32 b +Fq(indicates)37 b(the)f(completion)i(status.)66 b(If)35 +b(the)h(v)n(alue)g(is)g(an)o(ything)h(other)g(than)f Fp(SANE)p 3656 2334 V 31 w(STA-)0 2447 y(TUS)p 170 2447 -V 31 w(SUCCESS)p Fq(,)17 b(the)22 b(remainder)h(of)e(the)h(reply)g(has) -g(unde\002ned)h(v)n(alues.)29 b(The)21 b Fp(device)p -2875 2447 V 30 w(list)d Fq(ar)n(gument)24 b(is)d(a)f(pointer)0 -2560 y(to)j(a)h Fp(NULL)p Fq(-terminated)g(array)g(of)f -Fp(SANE)p 1349 2560 V 31 w(Device)d Fq(pointers.)0 2868 -y Fm(5.2.3)99 b Fc(SANE)p 545 2868 30 4 v 35 w(NET)p -760 2868 V 35 w(OPEN)0 3101 y Fq(RPC)22 b(Code:)29 b(2)0 -3272 y(This)23 b(RPC)f(is)h(used)i(to)e(open)i(a)e(connection)j(to)e(a) -f(remote)h(SANE)d(de)n(vice.)760 3513 y Fr(r)n(equest:)996 -b(r)n(eply:)760 3626 y Fp(SANE)p 985 3626 28 4 v 31 w(String)52 -b(device)p 1728 3626 V 30 w(name)98 b(SANE)p 2296 3626 -V 31 w(Word)52 b(status)2071 3739 y(SANE)p 2296 3739 -V 31 w(Word)g(handle)2071 3852 y(SANE)p 2296 3852 V 31 -w(String)f(resource)0 4089 y Fq(The)23 b Fp(device)p -499 4089 V 30 w(name)e Fq(ar)n(gument)k(speci\002es)g(the)f(name)g(of)f -(the)h(de)n(vice)h(to)e(open.)0 4261 y(In)35 b(the)h(reply)-6 -b(,)40 b Fp(status)32 b Fq(indicates)37 b(the)f(completion)i(status.)66 -b(If)35 b(the)h(v)n(alue)g(is)g(an)o(ything)h(other)g(than)f +V 31 w(GOOD)p Fq(,)23 b(the)k(remainder)g(of)f(the)g(reply)h(has)f +(unde\002ned)i(v)n(alues.)37 b(The)25 b Fp(device)p 2760 +2447 V 30 w(list)f Fq(ar)n(gument)j(is)f(a)g(pointer)h(to)0 +2560 y(a)c Fp(NULL)p Fq(-terminated)h(array)h(of)e Fp(SANE)p +1256 2560 V 31 w(Device)d Fq(pointers.)0 2868 y Fm(5.2.3)99 +b Fc(SANE)p 545 2868 30 4 v 35 w(NET)p 760 2868 V 35 +w(OPEN)0 3101 y Fq(RPC)22 b(Code:)29 b(2)0 3272 y(This)23 +b(RPC)f(is)h(used)i(to)e(open)i(a)e(connection)j(to)e(a)f(remote)h +(SANE)d(de)n(vice.)760 3513 y Fr(r)n(equest:)996 b(r)n(eply:)760 +3626 y Fp(SANE)p 985 3626 28 4 v 31 w(String)52 b(device)p +1728 3626 V 30 w(name)98 b(SANE)p 2296 3626 V 31 w(Word)52 +b(status)2071 3739 y(SANE)p 2296 3739 V 31 w(Word)g(handle)2071 +3852 y(SANE)p 2296 3852 V 31 w(String)f(resource)0 4089 +y Fq(The)23 b Fp(device)p 499 4089 V 30 w(name)e Fq(ar)n(gument)k +(speci\002es)g(the)f(name)g(of)f(the)h(de)n(vice)h(to)e(open.)0 +4261 y(In)35 b(the)h(reply)-6 b(,)40 b Fp(status)32 b +Fq(indicates)37 b(the)f(completion)i(status.)66 b(If)35 +b(the)h(v)n(alue)g(is)g(an)o(ything)h(other)g(than)f Fp(SANE)p 3656 4261 V 31 w(STA-)0 4374 y(TUS)p 170 4374 -V 31 w(SUCCESS)p Fq(,)31 b(the)36 b(remainder)h(of)f(the)f(reply)i(has) -e(unde\002ned)j(v)n(alues.)65 b(The)35 b Fp(handle)d -Fq(ar)n(gument)37 b(speci\002es)g(the)0 4487 y(de)n(vice)23 -b(handle)g(that)f(uniquely)i(identi\002es)g(the)e(connection.)31 -b(The)21 b Fp(resource)c Fq(ar)n(gument)24 b(is)d(used)i(to)e(request)j -(authenti-)0 4600 y(cation.)30 b(If)22 b(it)h(has)g(a)g(non-)p -Fp(NULL)e Fq(v)n(alue,)j(the)f(netw)o(ork)h(back)o(end)h(should)g -(authenticate)h(the)d(speci\002ed)h(resource)h(and)e(then)0 -4712 y(retry)h(this)g(operation)j(\(see)d(Section)g(5.2.10)g(for)g -(details)h(on)f(ho)n(w)f(to)g(authorize)j(a)d(resource\).)p -0 4794 1560 4 v 105 4849 a Ff(1)134 4881 y Fe(The)c(sane)h(netw)o(ork)g -(daemon)g(should)g(be)f(careful)g(not)g(to)g(leak)g(information)h(in)f -(the)g(unde\002ned)h(portion)f(of)g(the)g(reply)-5 b(.)1905 -5381 y Fq(39)p eop end +V 31 w(GOOD)p Fq(,)26 b(the)j(remainder)i(of)e(the)g(reply)g(has)g +(unde\002ned)i(v)n(alues.)46 b(The)28 b Fp(handle)d Fq(ar)n(gument)31 +b(speci\002es)f(the)f(de)n(vice)0 4487 y(handle)d(that)g(uniquely)h +(identi\002es)f(the)f(connection.)36 b(The)24 b Fp(resource)c +Fq(ar)n(gument)27 b(is)d(used)i(to)f(request)h(authentication.)0 +4600 y(If)h(it)h(has)g(a)f(non-)p Fp(NULL)g Fq(v)n(alue,)i(the)f(netw)o +(ork)h(back)o(end)h(should)g(authenticate)h(the)d(speci\002ed)h +(resource)h(and)e(then)g(retry)0 4712 y(this)c(operation)i(\(see)e +(Section)h(5.2.10)f(for)f(details)j(on)d(ho)n(w)g(to)h(authorize)i(a)d +(resource\).)p 0 4794 1560 4 v 105 4849 a Ff(1)134 4881 +y Fe(The)c(sane)h(netw)o(ork)g(daemon)g(should)g(be)f(careful)g(not)g +(to)g(leak)g(information)h(in)f(the)g(unde\002ned)h(portion)f(of)g(the) +g(reply)-5 b(.)1905 5381 y Fq(39)p eop end %%Page: 40 41 TeXDict begin 40 40 bop 0 123 a Fm(5.2.4)99 b Fc(SANE)p 545 123 30 4 v 35 w(NET)p 760 123 V 35 w(CLOSE)0 351 @@ -4412,15 +4415,15 @@ b(ar)n(gument)g Fp(resource)19 b Fq(is)k(set)g(to)f(the)h(name)g(of)g (the)g(resource)i(that)f(must)e(be)h(authorized)j(before)e(this)g(call) 0 1424 y(can)h(be)f(retried.)33 b(If)24 b(this)h(v)n(alue)h(is)e(non-)p Fp(NULL)p Fq(,)f(all)i(other)g(ar)n(guments)i(ha)n(v)o(e)e(unde\002ned) -h(v)n(alues)g(\(see)f(Section)g(5.2.10)g(for)0 1536 y(details)i(on)f -(ho)n(w)e(to)i(authorize)i(a)d(resource\).)37 b(Ar)n(gument)26 -b Fp(status)c Fq(indicates)28 b(the)e(completion)h(status.)36 -b(If)25 b(the)h(v)n(alue)g(is)0 1649 y(an)o(ything)e(other)f(than)f -Fp(SANE)p 948 1649 V 31 w(STATUS)p 1309 1649 V 30 w(SUCCESS)p -Fq(,)17 b(the)23 b(remainder)g(of)f(the)g(reply)h(has)f(unde\002ned)h -(v)n(alues.)29 b(The)22 b Fp(info)0 1762 y Fq(ar)n(gument)f(returns)g -(the)f(information)i(on)d(ho)n(w)g(well)g(the)g(back)o(end)j(w)o(as)d -(able)h(to)f(satisfy)i(the)e(request.)29 b(F)o(or)19 +h(v)n(alues)g(\(see)f(Section)g(5.2.10)g(for)0 1536 y(details)31 +b(on)g(ho)n(w)e(to)h(authorize)i(a)e(resource\).)50 b(Ar)n(gument)31 +b Fp(status)c Fq(indicates)32 b(the)e(completion)i(status.)49 +b(If)30 b(the)g(v)n(alue)0 1649 y(is)d(an)o(ything)i(other)f(than)g +Fp(SANE)p 1051 1649 V 31 w(STATUS)p 1412 1649 V 30 w(GOOD)p +Fq(,)d(the)i(remainder)i(of)e(the)h(reply)g(has)f(unde\002ned)i(v)n +(alues.)41 b(The)27 b Fp(info)0 1762 y Fq(ar)n(gument)21 +b(returns)g(the)f(information)i(on)d(ho)n(w)g(well)g(the)g(back)o(end)j +(w)o(as)d(able)h(to)f(satisfy)i(the)e(request.)29 b(F)o(or)19 b(details,)i(see)f(the)0 1875 y(description)32 b(of)c(the)h (corresponding)j(ar)n(gument)e(in)f(Section)g(4.3.7.)43 b(Ar)n(guments)30 b Fp(value)p 2946 1875 V 31 w(type)c @@ -4447,13 +4450,14 @@ y Fq(The)33 b Fp(handle)d Fq(ar)n(gument)35 b(identi\002es)g(the)f -6 b(,)40 b Fp(status)32 b Fq(indicates)37 b(the)f(completion)i (status.)66 b(If)35 b(the)h(v)n(alue)g(is)g(an)o(ything)h(other)g(than) f Fp(SANE)p 3656 4028 V 31 w(STA-)0 4141 y(TUS)p 170 -4141 V 31 w(SUCCESS)p Fq(,)22 b(the)k(remainder)i(of)e(the)g(reply)h -(has)g(unde\002ned)g(v)n(alues.)38 b(The)25 b(ar)n(gument)j -Fp(params)22 b Fq(is)k(used)h(to)f(return)0 4254 y(the)e(scan)g -(parameters.)0 4561 y Fm(5.2.8)99 b Fc(SANE)p 545 4561 -30 4 v 35 w(NET)p 760 4561 V 35 w(START)0 4794 y Fq(RPC)22 -b(Code:)29 b(7)0 4966 y(This)23 b(RPC)f(is)h(used)i(to)e(start)h(image) -g(acquisition)j(\(scanning\).)1905 5381 y(41)p eop end +4141 V 31 w(GOOD)p Fq(,)25 b(the)j(remainder)h(of)e(the)h(reply)h(has)f +(unde\002ned)h(v)n(alues.)42 b(The)27 b(ar)n(gument)i +Fp(params)24 b Fq(is)j(used)i(to)e(return)i(the)0 4254 +y(scan)24 b(parameters.)0 4561 y Fm(5.2.8)99 b Fc(SANE)p +545 4561 30 4 v 35 w(NET)p 760 4561 V 35 w(START)0 4794 +y Fq(RPC)22 b(Code:)29 b(7)0 4966 y(This)23 b(RPC)f(is)h(used)i(to)e +(start)h(image)g(acquisition)j(\(scanning\).)1905 5381 +y(41)p eop end %%Page: 42 43 TeXDict begin 42 42 bop 940 111 a Fr(r)n(equest:)636 b(r)n(eply:)940 223 y Fp(SANE)p 1165 223 28 4 v 31 w(Word)53 @@ -4469,40 +4473,39 @@ b Fq(is)k(set)g(to)f(the)h(name)g(of)g(the)g(resource)i(that)f(must)e (be)h(authorized)j(before)e(this)g(call)0 1197 y(can)h(be)f(retried.)33 b(If)24 b(this)h(v)n(alue)h(is)e(non-)p Fp(NULL)p Fq(,)f(all)i(other)g (ar)n(guments)i(ha)n(v)o(e)e(unde\002ned)h(v)n(alues)g(\(see)f(Section) -g(5.2.10)g(for)0 1310 y(details)30 b(on)f(ho)n(w)f(to)h(authorize)i(a)d -(resource\).)47 b(Ar)n(gument,)30 b Fp(status)c Fq(indicates)31 -b(the)e(completion)i(status.)45 b(If)28 b(the)h(v)n(alue)0 -1423 y(is)j(an)o(ything)j(other)f(than)f Fp(SANE)p 1073 -1423 V 31 w(STATUS)p 1434 1423 V 30 w(SUCCESS)p Fq(,)28 -b(the)33 b(remainder)h(of)f(the)g(reply)g(has)g(unde\002ned)i(v)n -(alues.)57 b(The)0 1536 y(ar)n(gument)32 b Fp(port)27 -b Fq(returns)k(the)f(port)h(number)g(from)e(which)i(the)f(image)g(data) -g(will)g(be)g(a)n(v)n(ailable.)50 b(T)-7 b(o)28 b(read)j(the)f(image)0 -1649 y(data,)d(a)e(netw)o(ork)j(client)f(must)f(connect)i(to)e(the)g -(remote)g(host)h(at)f(the)g(indicated)j(port)d(number)-5 -b(.)37 b(Through)27 b(this)g(port,)g(the)0 1762 y(image)k(data)f(is)g -(transmitted)j(as)d(a)g(sequence)i(of)e(data)h(records.)50 -b(Each)31 b(record)g(starts)g(with)f(the)h(data)g(length)g(in)f(bytes.) -0 1875 y(The)22 b(data)h(length)h(is)f(transmitted)i(as)d(a)g(sequence) -j(of)e(four)g(bytes.)30 b(These)22 b(bytes)i(should)g(be)f(interpreted) -j(as)c(an)h(unsigned)0 1988 y(inte)o(ger)28 b(in)f(big-endian)j -(format.)40 b(The)26 b(four)i(length)g(bytes)g(are)g(follo)n(wed)g(by)f -(the)g(number)h(of)f(data)h(bytes)g(indicated)h(by)0 -2101 y(the)24 b(length.)31 b(Except)25 b(for)f(byte-order)l(,)j(the)d -(data)g(is)g(in)g(the)g(same)g(format)g(as)g(de\002ned)h(for)f -Fp(sane)p 3078 2101 V 31 w(read\(\))p Fq(.)i(Since)e(some)0 -2213 y(records)34 b(may)d(contain)j(no)e(data)g(at)g(all,)i(a)d(length) -j(v)n(alue)f(of)e(zero)i(is)f(perfectly)i(v)n(alid.)54 -b(The)32 b(special)h(length)h(v)n(alue)e(of)0 2326 y -Fp(0xffffffff)27 b Fq(is)32 b(used)i(to)e(indicate)i(the)f(end)g(of)f -(the)h(data)g(stream.)56 b(That)33 b(is,)h(after)f(recei)n(ving)i(a)d -(record)h(length)h(of)0 2439 y Fp(0xffffffff)p Fq(,)18 -b(the)24 b(netw)o(ork)g(client)h(should)g(close)g(the)f(data)g -(connection)j(and)d(stop)g(reading)h(data.)0 2611 y(Ar)n(gument)35 -b Fp(byte)p 625 2611 V 31 w(order)c Fq(speci\002es)36 -b(the)e(byte-order)j(of)e(the)f(image)h(data.)61 b(A)33 -b(v)n(alue)i(of)f(0x1234)i(indicates)h(little-)0 2724 -y(endian)26 b(format,)f(a)f(v)n(alue)i(of)e(0x4321)j(indicates)g +g(5.2.10)g(for)0 1310 y(details)h(on)e(ho)n(w)g(to)g(authorize)j(a)d +(resource\).)33 b(Ar)n(gument,)26 b Fp(status)20 b Fq(indicates)27 +b(the)e(completion)h(status.)33 b(If)24 b(the)g(v)n(alue)h(is)0 +1423 y(an)o(ything)i(other)f(than)f Fp(SANE)p 957 1423 +V 31 w(STATUS)p 1318 1423 V 30 w(GOOD)p Fq(,)d(the)j(remainder)h(of)f +(the)g(reply)h(has)f(unde\002ned)h(v)n(alues.)34 b(The)24 +b(ar)n(gument)0 1536 y Fp(port)32 b Fq(returns)k(the)f(port)g(number)h +(from)e(which)h(the)g(image)g(data)g(will)g(be)f(a)n(v)n(ailable.)64 +b(T)-7 b(o)34 b(read)h(the)g(image)g(data,)j(a)0 1649 +y(netw)o(ork)28 b(client)g(must)f(connect)i(to)e(the)g(remote)h(host)f +(at)g(the)g(indicated)j(port)d(number)-5 b(.)40 b(Through)28 +b(this)f(port,)i(the)e(image)0 1762 y(data)f(is)e(transmitted)k(as)d(a) +f(sequence)k(of)d(data)g(records.)35 b(Each)25 b(record)h(starts)h +(with)d(the)i(data)f(length)i(in)e(bytes.)34 b(The)25 +b(data)0 1875 y(length)d(is)f(transmitted)i(as)e(a)g(sequence)i(of)e +(four)g(bytes.)29 b(These)21 b(bytes)i(should)f(be)f(interpreted)j(as)d +(an)g(unsigned)i(inte)o(ger)f(in)0 1988 y(big-endian)28 +b(format.)33 b(The)25 b(four)g(length)i(bytes)f(are)f(follo)n(wed)h(by) +f(the)g(number)h(of)f(data)g(bytes)h(indicated)i(by)d(the)g(length.)0 +2101 y(Except)c(for)g(byte-order)l(,)j(the)c(data)h(is)g(in)f(the)h +(same)f(format)h(as)f(de\002ned)i(for)e Fp(sane)p 2620 +2101 V 31 w(read\(\))p Fq(.)k(Since)d(some)f(records)i(may)0 +2213 y(contain)29 b(no)f(data)g(at)f(all,)h(a)f(length)i(v)n(alue)f(of) +g(zero)g(is)f(perfectly)j(v)n(alid.)41 b(The)27 b(special)i(length)g(v) +n(alue)f(of)g Fp(0xffffffff)0 2326 y Fq(is)c(used)i(to)f(indicate)h +(the)f(end)g(of)g(the)g(data)g(stream.)33 b(That)24 b(is,)h(after)g +(recei)n(ving)i(a)d(record)i(length)g(of)f Fp(0xffffffff)p +Fq(,)19 b(the)0 2439 y(netw)o(ork)25 b(client)f(should)i(close)e(the)g +(data)g(connection)j(and)d(stop)g(reading)h(data.)0 2611 +y(Ar)n(gument)35 b Fp(byte)p 625 2611 V 31 w(order)c +Fq(speci\002es)36 b(the)e(byte-order)j(of)e(the)f(image)h(data.)61 +b(A)33 b(v)n(alue)i(of)f(0x1234)i(indicates)h(little-)0 +2724 y(endian)26 b(format,)f(a)f(v)n(alue)i(of)e(0x4321)j(indicates)g (big-endian)h(format.)k(All)24 b(other)i(v)n(alues)g(are)e(presently)j (unde\002ned)g(and)0 2837 y(reserv)o(ed)g(for)f(future)h(enhancements)i (of)c(this)h(protocol.)37 b(The)25 b(intent)i(is)e(that)h(a)g(netw)o