mirror
/
sane-project-website
kopia lustrzana https://gitlab.com/sane-project/website
1
0
Forkuj 0
Kod Zgłoszenia Projekty Wydania Wiki Aktywność

Replace occurrences of SANE_STATUS_SUCCESS with SANE_STATUS_GOOD.

merge-requests/1/head
Julien BLACHE 2008-05-03 17:08:30 +00:00
rodzic c0dd089958
commit 9ecf0b0bc1
2 zmienionych plików z 130 dodań i 127 usunięć
Pokaż statystyki Ściągnij plik aktualizacji Ściągnij plik porównania Expand all files Collapse all files

12
html/doc017.html
Wyświetl plik

@ -62,7 +62,7 @@ to the user. E.g., it could be used as the default-user name in
subsequent authentication calls.
<p>In the reply, <tt>status</tt> indicates the completion status. If the
value is anything other than <tt>SANE_STATUS_SUCCESS</tt>, the
value is anything other than <tt>SANE_STATUS_GOOD</tt>, the
remainder of the reply has undefined values.<a name="F2"><a href="footnotes.html#000002"><sup><fontsize=-2>2</font></sup></a></a> The <tt>version_code</tt> 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.
<p>In the reply, <tt>status</tt> indicates the completion status. If the
value is anything other than <tt>SANE_STATUS_SUCCESS</tt>, the
value is anything other than <tt>SANE_STATUS_GOOD</tt>, the
remainder of the reply has undefined values. The <tt>device_list</tt>
argument is a pointer to a <tt>NULL</tt>-terminated array of
<tt>SANE_Device</tt> pointers.
@ -133,7 +133,7 @@ The <tt>device_name</tt> argument specifies the name of the device to
open.
<p>In the reply, <tt>status</tt> indicates the completion status. If the
value is anything other than <tt>SANE_STATUS_SUCCESS</tt>, the
value is anything other than <tt>SANE_STATUS_GOOD</tt>, the
remainder of the reply has undefined values. The <tt>handle</tt>
argument specifies the device handle that uniquely identifies the
connection. The <tt>resource</tt> argument is used to request
@ -270,7 +270,7 @@ this value is non-<tt>NULL</tt>, all other arguments have undefined
values (see Section <a href="doc017.html#s5.2.10">5.2.10</a> for details on how to
authorize a resource). Argument <tt>status</tt> indicates the
completion status. If the value is anything other than
<tt>SANE_STATUS_SUCCESS</tt>, the remainder of the reply has undefined
<tt>SANE_STATUS_GOOD</tt>, the remainder of the reply has undefined
values. The <tt>info</tt> 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 <tt>handle</tt> argument identifies the connection to the remote
device whose scan parameters should be returned.
<p>In the reply, <tt>status</tt> indicates the completion status. If the
value is anything other than <tt>SANE_STATUS_SUCCESS</tt>, the
value is anything other than <tt>SANE_STATUS_GOOD</tt>, the
remainder of the reply has undefined values. The argument
<tt>params</tt> is used to return the scan parameters.
@ -356,7 +356,7 @@ this value is non-<tt>NULL</tt>, all other arguments have undefined
values (see Section <a href="doc017.html#s5.2.10">5.2.10</a> for details on how to
authorize a resource). Argument, <tt>status</tt> indicates the
completion status. If the value is anything other than
<tt>SANE_STATUS_SUCCESS</tt>, the remainder of the reply has
<tt>SANE_STATUS_GOOD</tt>, the remainder of the reply has
undefined values. The argument <tt>port</tt> 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

245
sane.ps
Wyświetl plik

@ -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