path: root/lib/ssh/doc/standard/draft-ietf-secsh-filexfer-03.2.ps

%!PS-Adobe-3.0
%%BoundingBox: 75 0 595 747
%%Title: Enscript Output
%%For: Magnus Thoang
%%Creator: GNU enscript 1.6.1
%%CreationDate: Wed Nov 12 12:18:50 2003
%%Orientation: Portrait
%%Pages: 18 0
%%DocumentMedia: A4 595 842 0 () ()
%%DocumentNeededResources: (atend)
%%EndComments
%%BeginProlog
%%BeginProcSet: PStoPS 1 15
userdict begin
[/showpage/erasepage/copypage]{dup where{pop dup load
 type/operatortype eq{1 array cvx dup 0 3 index cvx put
 bind def}{pop}ifelse}{pop}ifelse}forall
[/letter/legal/executivepage/a4/a4small/b5/com10envelope
 /monarchenvelope/c5envelope/dlenvelope/lettersmall/note
 /folio/quarto/a5]{dup where{dup wcheck{exch{}put}
 {pop{}def}ifelse}{pop}ifelse}forall
/setpagedevice {pop}bind 1 index where{dup wcheck{3 1 roll put}
 {pop def}ifelse}{def}ifelse
/PStoPSmatrix matrix currentmatrix def
/PStoPSxform matrix def/PStoPSclip{clippath}def
/defaultmatrix{PStoPSmatrix exch PStoPSxform exch concatmatrix}bind def
/initmatrix{matrix defaultmatrix setmatrix}bind def
/initclip[{matrix currentmatrix PStoPSmatrix setmatrix
 [{currentpoint}stopped{$error/newerror false put{newpath}}
 {/newpath cvx 3 1 roll/moveto cvx 4 array astore cvx}ifelse]
 {[/newpath cvx{/moveto cvx}{/lineto cvx}
 {/curveto cvx}{/closepath cvx}pathforall]cvx exch pop}
 stopped{$error/errorname get/invalidaccess eq{cleartomark
 $error/newerror false put cvx exec}{stop}ifelse}if}bind aload pop
 /initclip dup load dup type dup/operatortype eq{pop exch pop}
 {dup/arraytype eq exch/packedarraytype eq or
  {dup xcheck{exch pop aload pop}{pop cvx}ifelse}
  {pop cvx}ifelse}ifelse
 {newpath PStoPSclip clip newpath exec setmatrix} bind aload pop]cvx def
/initgraphics{initmatrix newpath initclip 1 setlinewidth
 0 setlinecap 0 setlinejoin []0 setdash 0 setgray
 10 setmiterlimit}bind def
end
%%EndProcSet
%%BeginResource: procset Enscript-Prolog 1.6 1
%
% Procedures.
%

/_S {	% save current state
  /_s save def
} def
/_R {	% restore from saved state
  _s restore
} def

/S {	% showpage protecting gstate
  gsave
  showpage
  grestore
} bind def

/MF {	% fontname newfontname -> -	make a new encoded font
  /newfontname exch def
  /fontname exch def

  /fontdict fontname findfont def
  /newfont fontdict maxlength dict def

  fontdict {
    exch
    dup /FID eq {
      % skip FID pair
      pop pop
    } {
      % copy to the new font dictionary
      exch newfont 3 1 roll put
    } ifelse
  } forall

  newfont /FontName newfontname put

  % insert only valid encoding vectors
  encoding_vector length 256 eq {
    newfont /Encoding encoding_vector put
  } if

  newfontname newfont definefont pop
} def

/SF { % fontname width height -> -	set a new font
  /height exch def
  /width exch def

  findfont
  [width 0 0 height 0 0] makefont setfont
} def

/SUF { % fontname width height -> -	set a new user font
  /height exch def
  /width exch def

  /F-gs-user-font MF
  /F-gs-user-font width height SF
} def

/M {moveto} bind def
/s {show} bind def

/Box {	% x y w h -> -			define box path
  /d_h exch def /d_w exch def /d_y exch def /d_x exch def
  d_x d_y  moveto
  d_w 0 rlineto
  0 d_h rlineto
  d_w neg 0 rlineto
  closepath
} def

/bgs {	% x y height blskip gray str -> -	show string with bg color
  /str exch def
  /gray exch def
  /blskip exch def
  /height exch def
  /y exch def
  /x exch def

  gsave
    x y blskip sub str stringwidth pop height Box
    gray setgray
    fill
  grestore
  x y M str s
} def

% Highlight bars.
/highlight_bars {	% nlines lineheight output_y_margin gray -> -
  gsave
    setgray
    /ymarg exch def
    /lineheight exch def
    /nlines exch def

    % This 2 is just a magic number to sync highlight lines to text.
    0 d_header_y ymarg sub 2 sub translate

    /cw d_output_w cols div def
    /nrows d_output_h ymarg 2 mul sub lineheight div cvi def

    % for each column
    0 1 cols 1 sub {
      cw mul /xp exch def

      % for each rows
      0 1 nrows 1 sub {
        /rn exch def
        rn lineheight mul neg /yp exch def
        rn nlines idiv 2 mod 0 eq {
	  % Draw highlight bar.  4 is just a magic indentation.
	  xp 4 add yp cw 8 sub lineheight neg Box fill
	} if
      } for
    } for

  grestore
} def

% Line highlight bar.
/line_highlight {	% x y width height gray -> -
  gsave
    /gray exch def
    Box gray setgray fill
  grestore
} def

% Column separator lines.
/column_lines {
  gsave
    .1 setlinewidth
    0 d_footer_h translate
    /cw d_output_w cols div def
    1 1 cols 1 sub {
      cw mul 0 moveto
      0 d_output_h rlineto stroke
    } for
  grestore
} def

% Column borders.
/column_borders {
  gsave
    .1 setlinewidth
    0 d_footer_h moveto
    0 d_output_h rlineto
    d_output_w 0 rlineto
    0 d_output_h neg rlineto
    closepath stroke
  grestore
} def

% Do the actual underlay drawing
/draw_underlay {
  ul_style 0 eq {
    ul_str true charpath stroke
  } {
    ul_str show
  } ifelse
} def

% Underlay
/underlay {	% - -> -
  gsave
    0 d_page_h translate
    d_page_h neg d_page_w atan rotate

    ul_gray setgray
    ul_font setfont
    /dw d_page_h dup mul d_page_w dup mul add sqrt def
    ul_str stringwidth pop dw exch sub 2 div ul_h_ptsize -2 div moveto
    draw_underlay
  grestore
} def

/user_underlay {	% - -> -
  gsave
    ul_x ul_y translate
    ul_angle rotate
    ul_gray setgray
    ul_font setfont
    0 0 ul_h_ptsize 2 div sub moveto
    draw_underlay
  grestore
} def

% Page prefeed
/page_prefeed {		% bool -> -
  statusdict /prefeed known {
    statusdict exch /prefeed exch put
  } {
    pop
  } ifelse
} def

% Wrapped line markers
/wrapped_line_mark {	% x y charwith charheight type -> -
  /type exch def
  /h exch def
  /w exch def
  /y exch def
  /x exch def

  type 2 eq {
    % Black boxes (like TeX does)
    gsave
      0 setlinewidth
      x w 4 div add y M
      0 h rlineto w 2 div 0 rlineto 0 h neg rlineto
      closepath fill
    grestore
  } {
    type 3 eq {
      % Small arrows
      gsave
        .2 setlinewidth
        x w 2 div add y h 2 div add M
        w 4 div 0 rlineto
        x w 4 div add y lineto stroke

        x w 4 div add w 8 div add y h 4 div add M
        x w 4 div add y lineto
	w 4 div h 8 div rlineto stroke
      grestore
    } {
      % do nothing
    } ifelse
  } ifelse
} def

% EPSF import.

/BeginEPSF {
  /b4_Inc_state save def    		% Save state for cleanup
  /dict_count countdictstack def	% Count objects on dict stack
  /op_count count 1 sub def		% Count objects on operand stack
  userdict begin
  /showpage { } def
  0 setgray 0 setlinecap
  1 setlinewidth 0 setlinejoin
  10 setmiterlimit [ ] 0 setdash newpath
  /languagelevel where {
    pop languagelevel
    1 ne {
      false setstrokeadjust false setoverprint
    } if
  } if
} bind def

/EndEPSF {
  count op_count sub { pos } repeat	% Clean up stacks
  countdictstack dict_count sub { end } repeat
  b4_Inc_state restore
} bind def

% Check PostScript language level.
/languagelevel where {
  pop /gs_languagelevel languagelevel def
} {
  /gs_languagelevel 1 def
} ifelse
%%EndResource
%%BeginResource: procset Enscript-Encoding-88591 1.6 1
/encoding_vector [
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/space        	/exclam       	/quotedbl     	/numbersign   	
/dollar       	/percent      	/ampersand    	/quoteright   	
/parenleft    	/parenright   	/asterisk     	/plus         	
/comma        	/hyphen       	/period       	/slash        	
/zero         	/one          	/two          	/three        	
/four         	/five         	/six          	/seven        	
/eight        	/nine         	/colon        	/semicolon    	
/less         	/equal        	/greater      	/question     	
/at           	/A            	/B            	/C            	
/D            	/E            	/F            	/G            	
/H            	/I            	/J            	/K            	
/L            	/M            	/N            	/O            	
/P            	/Q            	/R            	/S            	
/T            	/U            	/V            	/W            	
/X            	/Y            	/Z            	/bracketleft  	
/backslash    	/bracketright 	/asciicircum  	/underscore   	
/quoteleft    	/a            	/b            	/c            	
/d            	/e            	/f            	/g            	
/h            	/i            	/j            	/k            	
/l            	/m            	/n            	/o            	
/p            	/q            	/r            	/s            	
/t            	/u            	/v            	/w            	
/x            	/y            	/z            	/braceleft    	
/bar          	/braceright   	/tilde        	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/.notdef      	/.notdef      	/.notdef      	/.notdef      	
/space        	/exclamdown   	/cent         	/sterling     	
/currency     	/yen          	/brokenbar    	/section      	
/dieresis     	/copyright    	/ordfeminine  	/guillemotleft	
/logicalnot   	/hyphen       	/registered   	/macron       	
/degree       	/plusminus    	/twosuperior  	/threesuperior	
/acute        	/mu           	/paragraph    	/bullet       	
/cedilla      	/onesuperior  	/ordmasculine 	/guillemotright	
/onequarter   	/onehalf      	/threequarters	/questiondown 	
/Agrave       	/Aacute       	/Acircumflex  	/Atilde       	
/Adieresis    	/Aring        	/AE           	/Ccedilla     	
/Egrave       	/Eacute       	/Ecircumflex  	/Edieresis    	
/Igrave       	/Iacute       	/Icircumflex  	/Idieresis    	
/Eth          	/Ntilde       	/Ograve       	/Oacute       	
/Ocircumflex  	/Otilde       	/Odieresis    	/multiply     	
/Oslash       	/Ugrave       	/Uacute       	/Ucircumflex  	
/Udieresis    	/Yacute       	/Thorn        	/germandbls   	
/agrave       	/aacute       	/acircumflex  	/atilde       	
/adieresis    	/aring        	/ae           	/ccedilla     	
/egrave       	/eacute       	/ecircumflex  	/edieresis    	
/igrave       	/iacute       	/icircumflex  	/idieresis    	
/eth          	/ntilde       	/ograve       	/oacute       	
/ocircumflex  	/otilde       	/odieresis    	/divide       	
/oslash       	/ugrave       	/uacute       	/ucircumflex  	
/udieresis    	/yacute       	/thorn        	/ydieresis    	
] def
%%EndResource
%%EndProlog
%%BeginSetup
%%IncludeResource: font Courier-Bold
%%IncludeResource: font Courier
/HFpt_w 10 def
/HFpt_h 10 def
/Courier-Bold /HF-gs-font MF
/HF /HF-gs-font findfont [HFpt_w 0 0 HFpt_h 0 0] makefont def
/Courier /F-gs-font MF
/F-gs-font 10 10 SF
/#copies 1 def
/d_page_w 520 def
/d_page_h 747 def
/d_header_x 0 def
/d_header_y 747 def
/d_header_w 520 def
/d_header_h 0 def
/d_footer_x 0 def
/d_footer_y 0 def
/d_footer_w 520 def
/d_footer_h 0 def
/d_output_w 520 def
/d_output_h 747 def
/cols 1 def
userdict/PStoPSxform PStoPSmatrix matrix currentmatrix
 matrix invertmatrix matrix concatmatrix
 matrix invertmatrix put
%%EndSetup
%%Page: (0,1) 1
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 1 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 701 M
(Secure Shell Working Group                                  J. Galbraith) s
5 690 M
(Internet-Draft                                          VanDyke Software) s
5 679 M
(Expires: April 16, 2003                                        T. Ylonen) s
5 668 M
(                                                             S. Lehtinen) s
5 657 M
(                                        SSH Communications Security Corp) s
5 646 M
(                                                        October 16, 2002) s
5 613 M
(                       SSH File Transfer Protocol) s
5 602 M
(                    draft-ietf-secsh-filexfer-03.txt) s
5 580 M
(Status of this Memo) s
5 558 M
(   This document is an Internet-Draft and is in full conformance with) s
5 547 M
(   all provisions of Section 10 of RFC2026.) s
5 525 M
(   Internet-Drafts are working documents of the Internet Engineering) s
5 514 M
(   Task Force \(IETF\), its areas, and its working groups.  Note that) s
5 503 M
(   other groups may also distribute working documents as Internet-) s
5 492 M
(   Drafts.) s
5 470 M
(   Internet-Drafts are draft documents valid for a maximum of six months) s
5 459 M
(   and may be updated, replaced, or obsoleted by other documents at any) s
5 448 M
(   time.  It is inappropriate to use Internet-Drafts as reference) s
5 437 M
(   material or to cite them other than as "work in progress.") s
5 415 M
(   The list of current Internet-Drafts can be accessed at http://) s
5 404 M
(   www.ietf.org/ietf/1id-abstracts.txt.) s
5 382 M
(   The list of Internet-Draft Shadow Directories can be accessed at) s
5 371 M
(   http://www.ietf.org/shadow.html.) s
5 349 M
(   This Internet-Draft will expire on April 16, 2003.) s
5 327 M
(Copyright Notice) s
5 305 M
(   Copyright \(C\) The Internet Society \(2002\).  All Rights Reserved.) s
5 283 M
(Abstract) s
5 261 M
(   The SSH File Transfer Protocol provides secure file transfer) s
5 250 M
(   functionality over any reliable data stream.  It is the standard file) s
5 239 M
(   transfer protocol for use with the SSH2 protocol.  This document) s
5 228 M
(   describes the file transfer protocol and its interface to the SSH2) s
5 217 M
(   protocol suite.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                 [Page 1]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 2 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(Table of Contents) s
5 668 M
(   1.     Introduction . . . . . . . . . . . . . . . . . . . . . . .   3) s
5 657 M
(   2.     Use with the SSH Connection Protocol . . . . . . . . . . .   4) s
5 646 M
(   3.     General Packet Format  . . . . . . . . . . . . . . . . . .   5) s
5 635 M
(   4.     Protocol Initialization  . . . . . . . . . . . . . . . . .   7) s
5 624 M
(   4.1    Client Initialization  . . . . . . . . . . . . . . . . . .   7) s
5 613 M
(   4.2    Server Initialization  . . . . . . . . . . . . . . . . . .   7) s
5 602 M
(   4.3    Determining Server Newline Convention  . . . . . . . . . .   8) s
5 591 M
(   5.     File Attributes  . . . . . . . . . . . . . . . . . . . . .   9) s
5 580 M
(   5.1    Flags  . . . . . . . . . . . . . . . . . . . . . . . . . .   9) s
5 569 M
(   5.2    Type . . . . . . . . . . . . . . . . . . . . . . . . . . .  10) s
5 558 M
(   5.3    Size . . . . . . . . . . . . . . . . . . . . . . . . . . .  10) s
5 547 M
(   5.4    Owner and Group  . . . . . . . . . . . . . . . . . . . . .  10) s
5 536 M
(   5.5    Permissions  . . . . . . . . . . . . . . . . . . . . . . .  11) s
5 525 M
(   5.6    Times  . . . . . . . . . . . . . . . . . . . . . . . . . .  11) s
5 514 M
(   5.7    ACL  . . . . . . . . . . . . . . . . . . . . . . . . . . .  11) s
5 503 M
(   5.8    Extended attributes  . . . . . . . . . . . . . . . . . . .  12) s
5 492 M
(   6.     Requests From the Client to the Server . . . . . . . . . .  13) s
5 481 M
(   6.1    Request Synchronization and Reordering . . . . . . . . . .  13) s
5 470 M
(   6.2    File Names . . . . . . . . . . . . . . . . . . . . . . . .  14) s
5 459 M
(   6.3    Opening, Creating, and Closing Files . . . . . . . . . . .  14) s
5 448 M
(   6.4    Reading and Writing  . . . . . . . . . . . . . . . . . . .  17) s
5 437 M
(   6.5    Removing and Renaming Files  . . . . . . . . . . . . . . .  18) s
5 426 M
(   6.6    Creating and Deleting Directories  . . . . . . . . . . . .  19) s
5 415 M
(   6.7    Scanning Directories . . . . . . . . . . . . . . . . . . .  19) s
5 404 M
(   6.8    Retrieving File Attributes . . . . . . . . . . . . . . . .  20) s
5 393 M
(   6.9    Setting File Attributes  . . . . . . . . . . . . . . . . .  21) s
5 382 M
(   6.10   Dealing with Symbolic links  . . . . . . . . . . . . . . .  22) s
5 371 M
(   6.11   Canonicalizing the Server-Side Path Name . . . . . . . . .  23) s
5 360 M
(   6.11.1 Best practice for dealing with paths . . . . . . . . . . .  23) s
5 349 M
(   7.     Responses from the Server to the Client  . . . . . . . . .  24) s
5 338 M
(   8.     Vendor-Specific Extensions . . . . . . . . . . . . . . . .  28) s
5 327 M
(   9.     Security Considerations  . . . . . . . . . . . . . . . . .  29) s
5 316 M
(   10.    Changes from previous protocol versions  . . . . . . . . .  30) s
5 305 M
(   10.1   Changes between versions 4 and 3 . . . . . . . . . . . . .  30) s
5 294 M
(   10.2   Changes between versions 3 and 2 . . . . . . . . . . . . .  31) s
5 283 M
(   10.3   Changes between versions 2 and 1 . . . . . . . . . . . . .  31) s
5 272 M
(   10.4   Changes between versions 1 and 0 . . . . . . . . . . . . .  31) s
5 261 M
(   11.    Trademark Issues . . . . . . . . . . . . . . . . . . . . .  32) s
5 250 M
(          References . . . . . . . . . . . . . . . . . . . . . . . .  33) s
5 239 M
(          Authors' Addresses . . . . . . . . . . . . . . . . . . . .  33) s
5 228 M
(          Full Copyright Statement . . . . . . . . . . . . . . . . .  35) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                 [Page 2]) s
_R
S
PStoPSsaved restore
%%Page: (2,3) 2
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 3 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(1. Introduction) s
5 668 M
(   This protocol provides secure file transfer \(and more generally file) s
5 657 M
(   system access\) functionality over a reliable data stream, such as a) s
5 646 M
(   channel in the SSH2 protocol [5].) s
5 624 M
(   This protocol is designed so that it could be used to implement a) s
5 613 M
(   secure remote file system service, as well as a secure file transfer) s
5 602 M
(   service.) s
5 580 M
(   This protocol assumes that it runs over a secure channel, and that) s
5 569 M
(   the server has already authenticated the user at the client end, and) s
5 558 M
(   that the identity of the client user is externally available to the) s
5 547 M
(   server implementation.) s
5 525 M
(   In general, this protocol follows a simple request-response model.) s
5 514 M
(   Each request and response contains a sequence number and multiple) s
5 503 M
(   requests may be pending simultaneously.  There are a relatively large) s
5 492 M
(   number of different request messages, but a small number of possible) s
5 481 M
(   response messages.  Each request has one or more response messages) s
5 470 M
(   that may be returned in result \(e.g., a read either returns data or) s
5 459 M
(   reports error status\).) s
5 437 M
(   The packet format descriptions in this specification follow the) s
5 426 M
(   notation presented in the secsh architecture draft. [5]) s
5 404 M
(   Even though this protocol is described in the context of the SSH2) s
5 393 M
(   protocol, this protocol is general and independent of the rest of the) s
5 382 M
(   SSH2 protocol suite.  It could be used in a number of different) s
5 371 M
(   applications, such as secure file transfer over TLS RFC 2246 [1] and) s
5 360 M
(   transfer of management information in VPN applications.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                 [Page 3]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 4 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(2. Use with the SSH Connection Protocol) s
5 668 M
(   When used with the SSH2 Protocol suite, this protocol is intended to) s
5 657 M
(   be used from the SSH Connection Protocol [7] as a subsystem, as) s
5 646 M
(   described in section ``Starting a Shell or a Command''.  The) s
5 635 M
(   subsystem name used with this protocol is "sftp".) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                 [Page 4]) s
_R
S
PStoPSsaved restore
%%Page: (4,5) 3
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 5 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(3. General Packet Format) s
5 668 M
(   All packets transmitted over the secure connection are of the) s
5 657 M
(   following format:) s
5 635 M
(        uint32             length) s
5 624 M
(        byte               type) s
5 613 M
(        byte[length - 1]   data payload) s
5 591 M
(   That is, they are just data preceded by 32-bit length and 8-bit type) s
5 580 M
(   fields.  The `length' is the length of the data area, and does not) s
5 569 M
(   include the `length' field itself.  The format and interpretation of) s
5 558 M
(   the data area depends on the packet type.) s
5 536 M
(   All packet descriptions below only specify the packet type and the) s
5 525 M
(   data that goes into the data field.  Thus, they should be prefixed by) s
5 514 M
(   the `length' and `type' fields.) s
5 492 M
(   The maximum size of a packet is in practice determined by the client) s
5 481 M
(   \(the maximum size of read or write requests that it sends, plus a few) s
5 470 M
(   bytes of packet overhead\).  All servers SHOULD support packets of at) s
5 459 M
(   least 34000 bytes \(where the packet size refers to the full length,) s
5 448 M
(   including the header above\).  This should allow for reads and writes) s
5 437 M
(   of at most 32768 bytes.) s
5 415 M
(   There is no limit on the number of outstanding \(non-acknowledged\)) s
5 404 M
(   requests that the client may send to the server.  In practice this is) s
5 393 M
(   limited by the buffering available on the data stream and the queuing) s
5 382 M
(   performed by the server.  If the server's queues are full, it should) s
5 371 M
(   not read any more data from the stream, and flow control will prevent) s
5 360 M
(   the client from sending more requests.  Note, however, that while) s
5 349 M
(   there is no restriction on the protocol level, the client's API may) s
5 338 M
(   provide a limit in order to prevent infinite queuing of outgoing) s
5 327 M
(   requests at the client.) s
5 305 M
(   The following values are defined for packet types.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                 [Page 5]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 6 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(        #define SSH_FXP_INIT                1) s
5 679 M
(        #define SSH_FXP_VERSION             2) s
5 668 M
(        #define SSH_FXP_OPEN                3) s
5 657 M
(        #define SSH_FXP_CLOSE               4) s
5 646 M
(        #define SSH_FXP_READ                5) s
5 635 M
(        #define SSH_FXP_WRITE               6) s
5 624 M
(        #define SSH_FXP_LSTAT               7) s
5 613 M
(        #define SSH_FXP_FSTAT               8) s
5 602 M
(        #define SSH_FXP_SETSTAT             9) s
5 591 M
(        #define SSH_FXP_FSETSTAT           10) s
5 580 M
(        #define SSH_FXP_OPENDIR            11) s
5 569 M
(        #define SSH_FXP_READDIR            12) s
5 558 M
(        #define SSH_FXP_REMOVE             13) s
5 547 M
(        #define SSH_FXP_MKDIR              14) s
5 536 M
(        #define SSH_FXP_RMDIR              15) s
5 525 M
(        #define SSH_FXP_REALPATH           16) s
5 514 M
(        #define SSH_FXP_STAT               17) s
5 503 M
(        #define SSH_FXP_RENAME             18) s
5 492 M
(        #define SSH_FXP_READLINK           19) s
5 481 M
(        #define SSH_FXP_SYMLINK            20) s
5 459 M
(        #define SSH_FXP_STATUS            101) s
5 448 M
(        #define SSH_FXP_HANDLE            102) s
5 437 M
(        #define SSH_FXP_DATA              103) s
5 426 M
(        #define SSH_FXP_NAME              104) s
5 415 M
(        #define SSH_FXP_ATTRS             105) s
5 393 M
(        #define SSH_FXP_EXTENDED          200) s
5 382 M
(        #define SSH_FXP_EXTENDED_REPLY    201) s
5 360 M
(        RESERVED_FOR_EXTENSIONS            210-255) s
5 338 M
(   Additional packet types should only be defined if the protocol) s
5 327 M
(   version number \(see Section ``Protocol Initialization''\) is) s
5 316 M
(   incremented, and their use MUST be negotiated using the version) s
5 305 M
(   number.  However, the SSH_FXP_EXTENDED and SSH_FXP_EXTENDED_REPLY) s
5 294 M
(   packets can be used to implement vendor-specific extensions.  See) s
5 283 M
(   Section ``Vendor-Specific-Extensions'' for more details.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                 [Page 6]) s
_R
S
PStoPSsaved restore
%%Page: (6,7) 4
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 7 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(4. Protocol Initialization) s
5 668 M
(   When the file transfer protocol starts, the client first sends a) s
5 657 M
(   SSH_FXP_INIT \(including its version number\) packet to the server.) s
5 646 M
(   The server responds with a SSH_FXP_VERSION packet, supplying the) s
5 635 M
(   lowest of its own and the client's version number.  Both parties) s
5 624 M
(   should from then on adhere to particular version of the protocol.) s
5 602 M
(   The version number of the protocol specified in this document is 4.) s
5 591 M
(   The version number should be incremented for each incompatible) s
5 580 M
(   revision of this protocol.) s
5 558 M
(4.1 Client Initialization) s
5 536 M
(   The SSH_FXP_INIT packet \(from client to server\) has the following) s
5 525 M
(   data:) s
5 503 M
(                uint32 version) s
5 481 M
(   Version 3 of this protocol allowed clients to include extensions in) s
5 470 M
(   the SSH_FXP_INIT packet; however, this can cause interoperability) s
5 459 M
(   problems with version 1 and version 2 servers because the client must) s
5 448 M
(   send this packet before knowing the servers version.) s
5 426 M
(   In this version of the protocol, clients MUST use the) s
5 415 M
(   SSH_FXP_EXTENDED packet to send extensions to the server after) s
5 404 M
(   version exchange has completed.  Clients MUST NOT include extensions) s
5 393 M
(   in the version packet.  This will prevent interoperability problems) s
5 382 M
(   with older servers) s
5 360 M
(4.2 Server Initialization) s
5 338 M
(   The SSH_FXP_VERSION packet \(from server to client\) has the following) s
5 327 M
(   data:) s
5 305 M
(                uint32 version) s
5 294 M
(                <extension data>) s
5 272 M
(   'version' is the lower of the protocol version supported by the) s
5 261 M
(   server and the version number received from the client.) s
5 239 M
(   The extension data may be empty, or may be a sequence of) s
5 217 M
(                string extension_name) s
5 206 M
(                string extension_data) s
5 184 M
(   pairs \(both strings MUST always be present if one is, but the) s
5 173 M
(   `extension_data' string may be of zero length\).  If present, these) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                 [Page 7]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 8 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(   strings indicate extensions to the baseline protocol.  The) s
5 679 M
(   `extension_name' field\(s\) identify the name of the extension.  The) s
5 668 M
(   name should be of the form "name@domain", where the domain is the DNS) s
5 657 M
(   domain name of the organization defining the extension.  Additional) s
5 646 M
(   names that are not of this format may be defined later by the IETF.) s
5 635 M
(   Implementations MUST silently ignore any extensions whose name they) s
5 624 M
(   do not recognize.) s
5 602 M
(4.3 Determining Server Newline Convention) s
5 580 M
(   In order to correctly process text files in a cross platform) s
5 569 M
(   compatible way, the newline convention must be converted from that of) s
5 558 M
(   the server to that of the client, or, during an upload, from that of) s
5 547 M
(   the client to that of the server.) s
5 525 M
(   Versions 3 and prior of this protocol made no provisions for) s
5 514 M
(   processing text files.  Many clients implemented some sort of) s
5 503 M
(   conversion algorithm, but without either a 'canonical' on the wire) s
5 492 M
(   format or knowledge of the servers newline convention, correct) s
5 481 M
(   conversion was not always possible.) s
5 459 M
(   Starting with Version 4, the SSH_FXF_TEXT file open flag \(Section) s
5 448 M
(   6.3\) makes it possible to request that the server translate a file to) s
5 437 M
(   a 'canonical' on the wire format.  This format uses \\r\\n as the line) s
5 426 M
(   separator.) s
5 404 M
(   Servers for systems using multiple newline characters \(for example,) s
5 393 M
(   Mac OS X or VMS\) or systems using counted records, MUST translate to) s
5 382 M
(   the canonical form.) s
5 360 M
(   However, to ease the burden of implementation on servers that use a) s
5 349 M
(   single, simple separator sequence, the following extension allows the) s
5 338 M
(   canonical format to be changed.) s
5 316 M
(        string "newline") s
5 305 M
(        string new-canonical-separator \(usually "\\r" or "\\n" or "\\r\\n"\)) s
5 283 M
(   All clients MUST support this extension.) s
5 261 M
(   When processing text files, clients SHOULD NOT translate any) s
5 250 M
(   character or sequence that is not an exact match of the servers) s
5 239 M
(   newline separator.) s
5 217 M
(   In particular, if the newline sequence being used is the canonical) s
5 206 M
(   "\\r\\n" sequence, a lone \\r or a lone \\n SHOULD be written through) s
5 195 M
(   without change.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                 [Page 8]) s
_R
S
PStoPSsaved restore
%%Page: (8,9) 5
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 9 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(5. File Attributes) s
5 668 M
(   A new compound data type is defined for encoding file attributes.) s
5 657 M
(   The same encoding is used both when returning file attributes from) s
5 646 M
(   the server and when sending file attributes to the server.  When) s
5 635 M
(   sending it to the server, the flags field specifies which attributes) s
5 624 M
(   are included, and the server will use default values for the) s
5 613 M
(   remaining attributes \(or will not modify the values of remaining) s
5 602 M
(   attributes\).  When receiving attributes from the server, the flags) s
5 591 M
(   specify which attributes are included in the returned data.  The) s
5 580 M
(   server normally returns all attributes it knows about.) s
5 558 M
(        uint32   flags) s
5 547 M
(        byte     type           always present) s
5 536 M
(        uint64   size           present only if flag SSH_FILEXFER_ATTR_SIZE) s
5 525 M
(        string   owner          present only if flag SSH_FILEXFER_ATTR_OWNERGROUP) s
5 514 M
(        string   group          present only if flag SSH_FILEXFER_ATTR_OWNERGROUP) s
5 503 M
(        uint32   permissions    present only if flag SSH_FILEXFER_ATTR_PERMISSIONS) s
5 492 M
(        uint32   atime          present only if flag SSH_FILEXFER_ATTR_ACCESSTIME) s
5 481 M
(        uint32   createtime     present only if flag SSH_FILEXFER_ATTR_CREATETIME) s
5 470 M
(        uint32   mtime          present only if flag SSH_FILEXFER_ATTR_MODIFYTIME) s
5 459 M
(        string   acl            present only if flag SSH_FILEXFER_ATTR_ACL) s
5 448 M
(        uint32   extended_count present only if flag SSH_FILEXFER_ATTR_EXTENDED) s
5 437 M
(        string   extended_type) s
5 426 M
(        string   extended_data) s
5 415 M
(        ...      more extended data \(extended_type - extended_data pairs\),) s
5 404 M
(                   so that number of pairs equals extended_count) s
5 371 M
(5.1 Flags) s
5 349 M
(   The `flags' specify which of the fields are present.  Those fields) s
5 338 M
(   for which the corresponding flag is not set are not present \(not) s
5 327 M
(   included in the packet\).  New flags can only be added by incrementing) s
5 316 M
(   the protocol version number \(or by using the extension mechanism) s
5 305 M
(   described below\).) s
5 283 M
(   The flags bits are defined to have the following values:) s
5 261 M
(        #define SSH_FILEXFER_ATTR_SIZE            0x00000001) s
5 250 M
(        #define SSH_FILEXFER_ATTR_PERMISSIONS     0x00000004) s
5 239 M
(        #define SSH_FILEXFER_ATTR_ACCESSTIME      0x00000008) s
5 228 M
(        #define SSH_FILEXFER_ATTR_CREATETIME      0x00000010) s
5 217 M
(        #define SSH_FILEXFER_ATTR_MODIFYTIME      0x00000020) s
5 206 M
(        #define SSH_FILEXFER_ATTR_ACL             0x00000040) s
5 195 M
(        #define SSH_FILEXFER_ATTR_OWNERGROUP      0x00000080) s
5 184 M
(        #define SSH_FILEXFER_ATTR_EXTENDED        0x80000000) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                 [Page 9]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 10 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(   In previous versions of this protocol flags value 0x00000002 was) s
5 679 M
(   SSH_FILEXFER_ATTR_UIDGID.  This value is now unused, and OWNERGROUP) s
5 668 M
(   was given a new value in order to ease implementation burden.) s
5 657 M
(   0x00000002 MUST NOT appear in the mask.  Some future version of this) s
5 646 M
(   protocol may reuse flag 0x00000002.) s
5 624 M
(5.2 Type) s
5 602 M
(   The type field is always present.  The following types are defined:) s
5 580 M
(        #define SSH_FILEXFER_TYPE_REGULAR          1) s
5 569 M
(        #define SSH_FILEXFER_TYPE_DIRECTORY        2) s
5 558 M
(        #define SSH_FILEXFER_TYPE_SYMLINK          3) s
5 547 M
(        #define SSH_FILEXFER_TYPE_SPECIAL          4) s
5 536 M
(        #define SSH_FILEXFER_TYPE_UNKNOWN          5) s
5 514 M
(   On a POSIX system, these values would be derived from the permission) s
5 503 M
(   field.) s
5 481 M
(5.3 Size) s
5 459 M
(   The `size' field specifies the size of the file on disk, in bytes.) s
5 448 M
(   If it is present during file creation, it should be considered a hint) s
5 437 M
(   as to the files eventual size.) s
5 415 M
(   Files opened with the SSH_FXF_TEXT flag may have a size that is) s
5 404 M
(   greater or less than the value of the size field.) s
5 382 M
(5.4 Owner and Group) s
5 360 M
(   The `owner' and `group' fields are represented as UTF-8 strings; this) s
5 349 M
(   is the form used by NFS v4.  See NFS version 4 Protocol.  [3] The) s
5 338 M
(   following text is selected quotations from section 5.6.) s
5 316 M
(   To avoid a representation that is tied to a particular underlying) s
5 305 M
(   implementation at the client or server, the use of UTF-8 strings has) s
5 294 M
(   been chosen.  The string should be of the form user@dns_domain".) s
5 283 M
(   This will allow for a client and server that do not use the same) s
5 272 M
(   local representation the ability to translate to a common syntax that) s
5 261 M
(   can be interpreted by both.  In the case where there is no) s
5 250 M
(   translation available to the client or server, the attribute value) s
5 239 M
(   must be constructed without the "@".  Therefore, the absence of the @) s
5 228 M
(   from the owner or owner_group attribute signifies that no translation) s
5 217 M
(   was available and the receiver of the attribute should not place any) s
5 206 M
(   special meaning with the attribute value.  Even though the attribute) s
5 195 M
(   value can not be translated, it may still be useful.  In the case of) s
5 184 M
(   a client, the attribute string may be used for local display of) s
5 173 M
(   ownership.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 10]) s
_R
S
PStoPSsaved restore
%%Page: (10,11) 6
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 11 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(5.5 Permissions) s
5 668 M
(   The `permissions' field contains a bit mask of file permissions as) s
5 657 M
(   defined by POSIX [1].) s
5 635 M
(5.6 Times) s
5 613 M
(   The 'atime', 'createtime', and 'mtime' contain the access, creation,) s
5 602 M
(   and modification times of the files, respectively.  They are) s
5 591 M
(   represented as seconds from Jan 1, 1970 in UTC.) s
5 569 M
(5.7 ACL) s
5 547 M
(   The 'ACL' field contains an ACL similar to that defined in section) s
5 536 M
(   5.9 of NFS version 4 Protocol [3].) s
5 514 M
(           uint32   ace-count) s
5 492 M
(           repeated ace-count time:) s
5 481 M
(                uint32   ace-type) s
5 470 M
(                uint32   ace-flag) s
5 459 M
(                uint32   ace-mask) s
5 448 M
(                string   who [UTF-8]) s
5 426 M
(   ace-type is one of the following four values \(taken from NFS Version) s
5 415 M
(   4 Protocol [3]:) s
5 393 M
(        const ACE4_ACCESS_ALLOWED_ACE_TYPE      = 0x00000000;) s
5 382 M
(        const ACE4_ACCESS_DENIED_ACE_TYPE       = 0x00000001;) s
5 371 M
(        const ACE4_SYSTEM_AUDIT_ACE_TYPE        = 0x00000002;) s
5 360 M
(        const ACE4_SYSTEM_ALARM_ACE_TYPE        = 0x00000003;) s
5 338 M
(   ace-flag is a combination of the following flag values.  See NFS) s
5 327 M
(   Version 4 Protocol [3] section 5.9.2:) s
5 305 M
(        const ACE4_FILE_INHERIT_ACE             = 0x00000001;) s
5 294 M
(        const ACE4_DIRECTORY_INHERIT_ACE        = 0x00000002;) s
5 283 M
(        const ACE4_NO_PROPAGATE_INHERIT_ACE     = 0x00000004;) s
5 272 M
(        const ACE4_INHERIT_ONLY_ACE             = 0x00000008;) s
5 261 M
(        const ACE4_SUCCESSFUL_ACCESS_ACE_FLAG   = 0x00000010;) s
5 250 M
(        const ACE4_FAILED_ACCESS_ACE_FLAG       = 0x00000020;) s
5 239 M
(        const ACE4_IDENTIFIER_GROUP             = 0x00000040;) s
5 217 M
(   ace-mask is any combination of the following flags \(taken from NFS) s
5 206 M
(   Version 4 Protocol [3] section 5.9.3:) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 11]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 12 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(        const ACE4_READ_DATA            = 0x00000001;) s
5 679 M
(        const ACE4_LIST_DIRECTORY       = 0x00000001;) s
5 668 M
(        const ACE4_WRITE_DATA           = 0x00000002;) s
5 657 M
(        const ACE4_ADD_FILE             = 0x00000002;) s
5 646 M
(        const ACE4_APPEND_DATA          = 0x00000004;) s
5 635 M
(        const ACE4_ADD_SUBDIRECTORY     = 0x00000004;) s
5 624 M
(        const ACE4_READ_NAMED_ATTRS     = 0x00000008;) s
5 613 M
(        const ACE4_WRITE_NAMED_ATTRS    = 0x00000010;) s
5 602 M
(        const ACE4_EXECUTE              = 0x00000020;) s
5 591 M
(        const ACE4_DELETE_CHILD         = 0x00000040;) s
5 580 M
(        const ACE4_READ_ATTRIBUTES      = 0x00000080;) s
5 569 M
(        const ACE4_WRITE_ATTRIBUTES     = 0x00000100;) s
5 558 M
(        const ACE4_DELETE               = 0x00010000;) s
5 547 M
(        const ACE4_READ_ACL             = 0x00020000;) s
5 536 M
(        const ACE4_WRITE_ACL            = 0x00040000;) s
5 525 M
(        const ACE4_WRITE_OWNER          = 0x00080000;) s
5 514 M
(        const ACE4_SYNCHRONIZE          = 0x00100000;) s
5 492 M
(   who is a UTF-8 string of the form described in 'Owner and Group') s
5 481 M
(   \(Section 5.4\)) s
5 459 M
(5.8 Extended attributes) s
5 437 M
(   The SSH_FILEXFER_ATTR_EXTENDED flag provides a general extension) s
5 426 M
(   mechanism for vendor-specific extensions.  If the flag is specified,) s
5 415 M
(   then the `extended_count' field is present.  It specifies the number) s
5 404 M
(   of extended_type-extended_data pairs that follow.  Each of these) s
5 393 M
(   pairs specifies an extended attribute.  For each of the attributes,) s
5 382 M
(   the extended_type field should be a string of the format) s
5 371 M
(   "name@domain", where "domain" is a valid, registered domain name and) s
5 360 M
(   "name" identifies the method.  The IETF may later standardize certain) s
5 349 M
(   names that deviate from this format \(e.g., that do not contain the) s
5 338 M
(   "@" sign\).  The interpretation of `extended_data' depends on the) s
5 327 M
(   type.  Implementations SHOULD ignore extended data fields that they) s
5 316 M
(   do not understand.) s
5 294 M
(   Additional fields can be added to the attributes by either defining) s
5 283 M
(   additional bits to the flags field to indicate their presence, or by) s
5 272 M
(   defining extended attributes for them.  The extended attributes) s
5 261 M
(   mechanism is recommended for most purposes; additional flags bits) s
5 250 M
(   should only be defined by an IETF standards action that also) s
5 239 M
(   increments the protocol version number.  The use of such new fields) s
5 228 M
(   MUST be negotiated by the version number in the protocol exchange.) s
5 217 M
(   It is a protocol error if a packet with unsupported protocol bits is) s
5 206 M
(   received.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 12]) s
_R
S
PStoPSsaved restore
%%Page: (12,13) 7
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 13 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(6. Requests From the Client to the Server) s
5 668 M
(   Requests from the client to the server represent the various file) s
5 657 M
(   system operations.  Each request begins with an `id' field, which is) s
5 646 M
(   a 32-bit identifier identifying the request \(selected by the client\).) s
5 635 M
(   The same identifier will be returned in the response to the request.) s
5 624 M
(   One possible implementation is a monotonically increasing request) s
5 613 M
(   sequence number \(modulo 2^32\).) s
5 591 M
(   Many operations in the protocol operate on open files.  The) s
5 580 M
(   SSH_FXP_OPEN request can return a file handle \(which is an opaque) s
5 569 M
(   variable-length string\) which may be used to access the file later) s
5 558 M
(   \(e.g.  in a read operation\).  The client MUST NOT send requests the) s
5 547 M
(   server with bogus or closed handles.  However, the server MUST) s
5 536 M
(   perform adequate checks on the handle in order to avoid security) s
5 525 M
(   risks due to fabricated handles.) s
5 503 M
(   This design allows either stateful and stateless server) s
5 492 M
(   implementation, as well as an implementation which caches state) s
5 481 M
(   between requests but may also flush it.  The contents of the file) s
5 470 M
(   handle string are entirely up to the server and its design.  The) s
5 459 M
(   client should not modify or attempt to interpret the file handle) s
5 448 M
(   strings.) s
5 426 M
(   The file handle strings MUST NOT be longer than 256 bytes.) s
5 404 M
(6.1 Request Synchronization and Reordering) s
5 382 M
(   The protocol and implementations MUST process requests relating to) s
5 371 M
(   the same file in the order in which they are received.  In other) s
5 360 M
(   words, if an application submits multiple requests to the server, the) s
5 349 M
(   results in the responses will be the same as if it had sent the) s
5 338 M
(   requests one at a time and waited for the response in each case.  For) s
5 327 M
(   example, the server may process non-overlapping read/write requests) s
5 316 M
(   to the same file in parallel, but overlapping reads and writes cannot) s
5 305 M
(   be reordered or parallelized.  However, there are no ordering) s
5 294 M
(   restrictions on the server for processing requests from two different) s
5 283 M
(   file transfer connections.  The server may interleave and parallelize) s
5 272 M
(   them at will.) s
5 250 M
(   There are no restrictions on the order in which responses to) s
5 239 M
(   outstanding requests are delivered to the client, except that the) s
5 228 M
(   server must ensure fairness in the sense that processing of no) s
5 217 M
(   request will be indefinitely delayed even if the client is sending) s
5 206 M
(   other requests so that there are multiple outstanding requests all) s
5 195 M
(   the time.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 13]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 14 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(6.2 File Names) s
5 668 M
(   This protocol represents file names as strings.  File names are) s
5 657 M
(   assumed to use the slash \('/'\) character as a directory separator.) s
5 635 M
(   File names starting with a slash are "absolute", and are relative to) s
5 624 M
(   the root of the file system.  Names starting with any other character) s
5 613 M
(   are relative to the user's default directory \(home directory\).  Note) s
5 602 M
(   that identifying the user is assumed to take place outside of this) s
5 591 M
(   protocol.) s
5 569 M
(   Servers SHOULD interpret a path name component ".." as referring to) s
5 558 M
(   the parent directory, and "." as referring to the current directory.) s
5 547 M
(   If the server implementation limits access to certain parts of the) s
5 536 M
(   file system, it must be extra careful in parsing file names when) s
5 525 M
(   enforcing such restrictions.  There have been numerous reported) s
5 514 M
(   security bugs where a ".." in a path name has allowed access outside) s
5 503 M
(   the intended area.) s
5 481 M
(   An empty path name is valid, and it refers to the user's default) s
5 470 M
(   directory \(usually the user's home directory\).) s
5 448 M
(   Otherwise, no syntax is defined for file names by this specification.) s
5 437 M
(   Clients should not make any other assumptions; however, they can) s
5 426 M
(   splice path name components returned by SSH_FXP_READDIR together) s
5 415 M
(   using a slash \('/'\) as the separator, and that will work as expected.) s
5 393 M
(   In order to comply with IETF Policy on Character Sets and Languages) s
5 382 M
(   [2], all filenames are to be encoded in UTF-8.  The shortest valid) s
5 371 M
(   UTF-8 encoding of the UNICODE data MUST be used.  The server is) s
5 360 M
(   responsible for converting the UNICODE data to whatever canonical) s
5 349 M
(   form it requires.) s
5 327 M
(   For example, if the server requires that precomposed characters) s
5 316 M
(   always be used, the server MUST NOT assume the filename as sent by) s
5 305 M
(   the client has this attribute, but must do this normalization itself.) s
5 283 M
(   It is understood that the lack of well-defined semantics for file) s
5 272 M
(   names may cause interoperability problems between clients and servers) s
5 261 M
(   using radically different operating systems.  However, this approach) s
5 250 M
(   is known to work acceptably with most systems, and alternative) s
5 239 M
(   approaches that e.g.  treat file names as sequences of structured) s
5 228 M
(   components are quite complicated.) s
5 206 M
(6.3 Opening, Creating, and Closing Files) s
5 184 M
(   Files are opened and created using the SSH_FXP_OPEN message, whose) s
5 173 M
(   data part is as follows:) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 14]) s
_R
S
PStoPSsaved restore
%%Page: (14,15) 8
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 15 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(        uint32        id) s
5 679 M
(        string        filename [UTF-8]) s
5 668 M
(        uint32        pflags) s
5 657 M
(        ATTRS         attrs) s
5 635 M
(   The `id' field is the request identifier as for all requests.) s
5 613 M
(   The `filename' field specifies the file name.  See Section ``File) s
5 602 M
(   Names'' for more information.) s
5 580 M
(   The `pflags' field is a bitmask.  The following bits have been) s
5 569 M
(   defined.) s
5 547 M
(        #define SSH_FXF_READ            0x00000001) s
5 536 M
(        #define SSH_FXF_WRITE           0x00000002) s
5 525 M
(        #define SSH_FXF_APPEND          0x00000004) s
5 514 M
(        #define SSH_FXF_CREAT           0x00000008) s
5 503 M
(        #define SSH_FXF_TRUNC           0x00000010) s
5 492 M
(        #define SSH_FXF_EXCL            0x00000020) s
5 481 M
(        #define SSH_FXF_TEXT            0x00000040) s
5 459 M
(   These have the following meanings:) s
5 437 M
(   SSH_FXF_READ) s
5 426 M
(      Open the file for reading.) s
5 404 M
(   SSH_FXF_WRITE) s
5 393 M
(      Open the file for writing.  If both this and SSH_FXF_READ are) s
5 382 M
(      specified, the file is opened for both reading and writing.) s
5 360 M
(   SSH_FXF_APPEND) s
5 349 M
(      Force all writes to append data at the end of the file.  The) s
5 338 M
(      offset parameter to write will be ignored.) s
5 316 M
(   SSH_FXF_CREAT) s
5 305 M
(      If this flag is specified, then a new file will be created if one) s
5 294 M
(      does not already exist \(if O_TRUNC is specified, the new file will) s
5 283 M
(      be truncated to zero length if it previously exists\).) s
5 261 M
(   SSH_FXF_TRUNC) s
5 250 M
(      Forces an existing file with the same name to be truncated to zero) s
5 239 M
(      length when creating a file by specifying SSH_FXF_CREAT.) s
5 228 M
(      SSH_FXF_CREAT MUST also be specified if this flag is used.) s
5 206 M
(   SSH_FXF_EXCL) s
5 195 M
(      Causes the request to fail if the named file already exists.) s
5 184 M
(      SSH_FXF_CREAT MUST also be specified if this flag is used.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 15]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 16 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(   SSH_FXF_TEXT) s
5 679 M
(      Indicates that the server should treat the file as text and) s
5 668 M
(      convert it to the canonical newline convention in use.  \(See) s
5 657 M
(      Determining Server Newline Convention. \(Section 4.3\)) s
5 635 M
(      When a file is opened with the FXF_TEXT flag, the offset field in) s
5 624 M
(      both the read and write function are ignored.) s
5 602 M
(      Servers MUST correctly process multiple parallel reads and writes) s
5 591 M
(      correctly in this mode.  Naturally, it is permissible for them to) s
5 580 M
(      do this by serializing the requests.  It would not be possible for) s
5 569 M
(      a client to reliably detect a server that does not implement) s
5 558 M
(      parallel writes in time to prevent damage.) s
5 536 M
(      Clients SHOULD use the SSH_FXF_APPEND flag to append data to a) s
5 525 M
(      text file rather then using write with a calculated offset.) s
5 503 M
(      To support seeks on text file the following SSH_FXP_EXTENDED) s
5 492 M
(      packet is defined.) s
5 448 M
(        string "text-seek") s
5 437 M
(        string file-handle) s
5 426 M
(        uint64 line-number) s
5 404 M
(      line-number is the index of the line number to seek to, where byte) s
5 393 M
(      0 in the file is line number 0, and the byte directly following) s
5 382 M
(      the first newline sequence in the file is line number 1 and so on.) s
5 360 M
(      The response to a "text-seek" request is an SSH_FXP_STATUS) s
5 349 M
(      message.) s
5 327 M
(      An attempt to seek past the end-of-file should result in a) s
5 316 M
(      SSH_FX_EOF status.) s
5 294 M
(      Servers SHOULD support at least one "text-seek" in order to) s
5 283 M
(      support resume.  However, a client MUST be prepared to receive) s
5 272 M
(      SSH_FX_OP_UNSUPPORTED when attempting a "text-seek" operation.) s
5 261 M
(      The client can then try a fall-back strategy, if it has one.) s
5 239 M
(      Clients MUST be prepared to handle SSH_FX_OP_UNSUPPORTED returned) s
5 228 M
(      for read or write operations that are not sequential.) s
5 206 M
(   The `attrs' field specifies the initial attributes for the file.) s
5 195 M
(   Default values will be used for those attributes that are not) s
5 184 M
(   specified.  See Section ``File Attributes'' for more information.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 16]) s
_R
S
PStoPSsaved restore
%%Page: (16,17) 9
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 17 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(   The response to this message will be either SSH_FXP_HANDLE \(if the) s
5 679 M
(   operation is successful\) or SSH_FXP_STATUS \(if the operation fails\).) s
5 657 M
(   A file is closed by using the SSH_FXP_CLOSE request.  Its data field) s
5 646 M
(   has the following format:) s
5 624 M
(        uint32     id) s
5 613 M
(        string     handle) s
5 591 M
(   where `id' is the request identifier, and `handle' is a handle) s
5 580 M
(   previously returned in the response to SSH_FXP_OPEN or) s
5 569 M
(   SSH_FXP_OPENDIR.  The handle becomes invalid immediately after this) s
5 558 M
(   request has been sent.) s
5 536 M
(   The response to this request will be a SSH_FXP_STATUS message.  One) s
5 525 M
(   should note that on some server platforms even a close can fail.) s
5 514 M
(   This can happen e.g.  if the server operating system caches writes,) s
5 503 M
(   and an error occurs while flushing cached writes during the close.) s
5 481 M
(6.4 Reading and Writing) s
5 459 M
(   Once a file has been opened, it can be read using the SSH_FXP_READ) s
5 448 M
(   message, which has the following format:) s
5 426 M
(        uint32     id) s
5 415 M
(        string     handle) s
5 404 M
(        uint64     offset) s
5 393 M
(        uint32     len) s
5 371 M
(   where `id' is the request identifier, `handle' is an open file handle) s
5 360 M
(   returned by SSH_FXP_OPEN, `offset' is the offset \(in bytes\) relative) s
5 349 M
(   to the beginning of the file from where to start reading, and `len') s
5 338 M
(   is the maximum number of bytes to read.) s
5 316 M
(   In response to this request, the server will read as many bytes as it) s
5 305 M
(   can from the file \(up to `len'\), and return them in a SSH_FXP_DATA) s
5 294 M
(   message.  If an error occurs or EOF is encountered before reading any) s
5 283 M
(   data, the server will respond with SSH_FXP_STATUS.  For normal disk) s
5 272 M
(   files, it is guaranteed that this will read the specified number of) s
5 261 M
(   bytes, or up to end of file.  For e.g.  device files this may return) s
5 250 M
(   fewer bytes than requested.) s
5 228 M
(   Writing to a file is achieved using the SSH_FXP_WRITE message, which) s
5 217 M
(   has the following format:) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 17]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 18 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(        uint32     id) s
5 679 M
(        string     handle) s
5 668 M
(        uint64     offset) s
5 657 M
(        string     data) s
5 635 M
(   where `id' is a request identifier, `handle' is a file handle) s
5 624 M
(   returned by SSH_FXP_OPEN, `offset' is the offset \(in bytes\) from the) s
5 613 M
(   beginning of the file where to start writing, and `data' is the data) s
5 602 M
(   to be written.) s
5 580 M
(   The write will extend the file if writing beyond the end of the file.) s
5 569 M
(   It is legal to write way beyond the end of the file; the semantics) s
5 558 M
(   are to write zeroes from the end of the file to the specified offset) s
5 547 M
(   and then the data.  On most operating systems, such writes do not) s
5 536 M
(   allocate disk space but instead leave "holes" in the file.) s
5 514 M
(   The server responds to a write request with a SSH_FXP_STATUS message.) s
5 492 M
(6.5 Removing and Renaming Files) s
5 470 M
(   Files can be removed using the SSH_FXP_REMOVE message.  It has the) s
5 459 M
(   following format:) s
5 437 M
(        uint32     id) s
5 426 M
(        string     filename [UTF-8]) s
5 404 M
(   where `id' is the request identifier and `filename' is the name of) s
5 393 M
(   the file to be removed.  See Section ``File Names'' for more) s
5 382 M
(   information.  This request cannot be used to remove directories.) s
5 360 M
(   The server will respond to this request with a SSH_FXP_STATUS) s
5 349 M
(   message.) s
5 327 M
(   Files \(and directories\) can be renamed using the SSH_FXP_RENAME) s
5 316 M
(   message.  Its data is as follows:) s
5 294 M
(        uint32     id) s
5 283 M
(        string     oldpath [UTF-8]) s
5 272 M
(        string     newpath [UTF-8]) s
5 250 M
(   where `id' is the request identifier, `oldpath' is the name of an) s
5 239 M
(   existing file or directory, and `newpath' is the new name for the) s
5 228 M
(   file or directory.  It is an error if there already exists a file) s
5 217 M
(   with the name specified by newpath.  The server may also fail rename) s
5 206 M
(   requests in other situations, for example if `oldpath' and `newpath') s
5 195 M
(   point to different file systems on the server.) s
5 173 M
(   The server will respond to this request with a SSH_FXP_STATUS) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 18]) s
_R
S
PStoPSsaved restore
%%Page: (18,19) 10
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 19 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(   message.) s
5 668 M
(6.6 Creating and Deleting Directories) s
5 646 M
(   New directories can be created using the SSH_FXP_MKDIR request.  It) s
5 635 M
(   has the following format:) s
5 613 M
(        uint32     id) s
5 602 M
(        string     path [UTF-8]) s
5 591 M
(        ATTRS      attrs) s
5 569 M
(   where `id' is the request identifier.) s
5 547 M
(   `path' specifies the directory to be created.  See Section ``File) s
5 536 M
(   Names'' for more information on file names.) s
5 514 M
(   `attrs' specifies the attributes that should be applied to it upon) s
5 503 M
(   creation.  Attributes are discussed in more detail in Section ``File) s
5 492 M
(   Attributes''.) s
5 470 M
(   The server will respond to this request with a SSH_FXP_STATUS) s
5 459 M
(   message.  If a file or directory with the specified path already) s
5 448 M
(   exists, an error will be returned.) s
5 426 M
(   Directories can be removed using the SSH_FXP_RMDIR request, which has) s
5 415 M
(   the following format:) s
5 393 M
(        uint32     id) s
5 382 M
(        string     path [UTF-8]) s
5 360 M
(   where `id' is the request identifier, and `path' specifies the) s
5 349 M
(   directory to be removed.  See Section ``File Names'' for more) s
5 338 M
(   information on file names.) s
5 316 M
(   The server responds to this request with a SSH_FXP_STATUS message.) s
5 305 M
(   Errors may be returned from this operation for various reasons,) s
5 294 M
(   including, but not limited to, the path does not exist, the path does) s
5 283 M
(   not refer to a directory object, the directory is not empty, or the) s
5 272 M
(   user has insufficient access or permission to perform the requested) s
5 261 M
(   operation.) s
5 239 M
(6.7 Scanning Directories) s
5 217 M
(   The files in a directory can be listed using the SSH_FXP_OPENDIR and) s
5 206 M
(   SSH_FXP_READDIR requests.  Each SSH_FXP_READDIR request returns one) s
5 195 M
(   or more file names with full file attributes for each file.  The) s
5 184 M
(   client should call SSH_FXP_READDIR repeatedly until it has found the) s
5 173 M
(   file it is looking for or until the server responds with a) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 19]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 20 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(   SSH_FXP_STATUS message indicating an error \(normally SSH_FX_EOF if) s
5 679 M
(   there are no more files in the directory\).  The client should then) s
5 668 M
(   close the handle using the SSH_FXP_CLOSE request.) s
5 646 M
(   The SSH_FXP_OPENDIR opens a directory for reading.  It has the) s
5 635 M
(   following format:) s
5 613 M
(        uint32     id) s
5 602 M
(        string     path [UTF-8]) s
5 580 M
(   where `id' is the request identifier and `path' is the path name of) s
5 569 M
(   the directory to be listed \(without any trailing slash\).  See Section) s
5 558 M
(   ``File Names'' for more information on file names.  This will return) s
5 547 M
(   an error if the path does not specify a directory or if the directory) s
5 536 M
(   is not readable.  The server will respond to this request with either) s
5 525 M
(   a SSH_FXP_HANDLE or a SSH_FXP_STATUS message.) s
5 503 M
(   Once the directory has been successfully opened, files \(and) s
5 492 M
(   directories\) contained in it can be listed using SSH_FXP_READDIR) s
5 481 M
(   requests.  These are of the format) s
5 459 M
(        uint32     id) s
5 448 M
(        string     handle) s
5 426 M
(   where `id' is the request identifier, and `handle' is a handle) s
5 415 M
(   returned by SSH_FXP_OPENDIR.  \(It is a protocol error to attempt to) s
5 404 M
(   use an ordinary file handle returned by SSH_FXP_OPEN.\)) s
5 382 M
(   The server responds to this request with either a SSH_FXP_NAME or a) s
5 371 M
(   SSH_FXP_STATUS message.  One or more names may be returned at a time.) s
5 360 M
(   Full status information is returned for each name in order to speed) s
5 349 M
(   up typical directory listings.) s
5 327 M
(   If there are no more names available to be read, the server MUST) s
5 316 M
(   respond with a SSH_FXP_STATUS message with error code of SSH_FX_EOF.) s
5 294 M
(   When the client no longer wishes to read more names from the) s
5 283 M
(   directory, it SHOULD call SSH_FXP_CLOSE for the handle.  The handle) s
5 272 M
(   should be closed regardless of whether an error has occurred or not.) s
5 250 M
(6.8 Retrieving File Attributes) s
5 228 M
(   Very often, file attributes are automatically returned by) s
5 217 M
(   SSH_FXP_READDIR.  However, sometimes there is need to specifically) s
5 206 M
(   retrieve the attributes for a named file.  This can be done using the) s
5 195 M
(   SSH_FXP_STAT, SSH_FXP_LSTAT and SSH_FXP_FSTAT requests.) s
5 173 M
(   SSH_FXP_STAT and SSH_FXP_LSTAT only differ in that SSH_FXP_STAT) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 20]) s
_R
S
PStoPSsaved restore
%%Page: (20,21) 11
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 21 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(   follows symbolic links on the server, whereas SSH_FXP_LSTAT does not) s
5 679 M
(   follow symbolic links.  Both have the same format:) s
5 657 M
(        uint32     id) s
5 646 M
(        string     path [UTF-8]) s
5 635 M
(        uint32     flags) s
5 613 M
(   where `id' is the request identifier, and `path' specifies the file) s
5 602 M
(   system object for which status is to be returned.  The server) s
5 591 M
(   responds to this request with either SSH_FXP_ATTRS or SSH_FXP_STATUS.) s
5 569 M
(   The flags field specify the attribute flags in which the client has) s
5 558 M
(   particular interest.  This is a hint to the server.  For example,) s
5 547 M
(   because retrieving owner / group and acl information can be an) s
5 536 M
(   expensive operation under some operating systems, the server may) s
5 525 M
(   choose not to retrieve this information unless the client expresses a) s
5 514 M
(   specific interest in it.) s
5 492 M
(   The client has no guarantee the server will provide all the fields) s
5 481 M
(   that it has expressed an interest in.) s
5 459 M
(   SSH_FXP_FSTAT differs from the others in that it returns status) s
5 448 M
(   information for an open file \(identified by the file handle\).  Its) s
5 437 M
(   format is as follows:) s
5 415 M
(        uint32     id) s
5 404 M
(        string     handle) s
5 393 M
(        uint32     flags) s
5 371 M
(   where `id' is the request identifier and `handle' is a file handle) s
5 360 M
(   returned by SSH_FXP_OPEN.  The server responds to this request with) s
5 349 M
(   SSH_FXP_ATTRS or SSH_FXP_STATUS.) s
5 327 M
(6.9 Setting File Attributes) s
5 305 M
(   File attributes may be modified using the SSH_FXP_SETSTAT and) s
5 294 M
(   SSH_FXP_FSETSTAT requests.  These requests are used for operations) s
5 283 M
(   such as changing the ownership, permissions or access times, as well) s
5 272 M
(   as for truncating a file.) s
5 250 M
(   The SSH_FXP_SETSTAT request is of the following format:) s
5 228 M
(        uint32     id) s
5 217 M
(        string     path [UTF-8]) s
5 206 M
(        ATTRS      attrs) s
5 184 M
(   where `id' is the request identifier, `path' specifies the file) s
5 173 M
(   system object \(e.g.  file or directory\) whose attributes are to be) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 21]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 22 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(   modified, and `attrs' specifies the modifications to be made to its) s
5 679 M
(   attributes.  Attributes are discussed in more detail in Section) s
5 668 M
(   ``File Attributes''.) s
5 646 M
(   An error will be returned if the specified file system object does) s
5 635 M
(   not exist or the user does not have sufficient rights to modify the) s
5 624 M
(   specified attributes.  The server responds to this request with a) s
5 613 M
(   SSH_FXP_STATUS message.) s
5 591 M
(   The SSH_FXP_FSETSTAT request modifies the attributes of a file which) s
5 580 M
(   is already open.  It has the following format:) s
5 558 M
(        uint32     id) s
5 547 M
(        string     handle) s
5 536 M
(        ATTRS      attrs) s
5 514 M
(   where `id' is the request identifier, `handle' \(MUST be returned by) s
5 503 M
(   SSH_FXP_OPEN\) identifies the file whose attributes are to be) s
5 492 M
(   modified, and `attrs' specifies the modifications to be made to its) s
5 481 M
(   attributes.  Attributes are discussed in more detail in Section) s
5 470 M
(   ``File Attributes''.  The server will respond to this request with) s
5 459 M
(   SSH_FXP_STATUS.) s
5 437 M
(6.10 Dealing with Symbolic links) s
5 415 M
(   The SSH_FXP_READLINK request may be used to read the target of a) s
5 404 M
(   symbolic link.  It would have a data part as follows:) s
5 382 M
(        uint32     id) s
5 371 M
(        string     path [UTF-8]) s
5 349 M
(   where `id' is the request identifier and `path' specifies the path) s
5 338 M
(   name of the symlink to be read.) s
5 316 M
(   The server will respond with a SSH_FXP_NAME packet containing only) s
5 305 M
(   one name and a dummy attributes value.  The name in the returned) s
5 294 M
(   packet contains the target of the link.  If an error occurs, the) s
5 283 M
(   server may respond with SSH_FXP_STATUS.) s
5 261 M
(   The SSH_FXP_SYMLINK request will create a symbolic link on the) s
5 250 M
(   server.  It is of the following format) s
5 228 M
(        uint32     id) s
5 217 M
(        string     linkpath   [UTF-8]) s
5 206 M
(        string     targetpath [UTF-8]) s
5 184 M
(   where `id' is the request identifier, `linkpath' specifies the path) s
5 173 M
(   name of the symlink to be created and `targetpath' specifies the) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 22]) s
_R
S
PStoPSsaved restore
%%Page: (22,23) 12
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 23 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(   target of the symlink.  The server shall respond with a) s
5 679 M
(   SSH_FXP_STATUS indicating either success \(SSH_FX_OK\) or an error) s
5 668 M
(   condition.) s
5 646 M
(6.11 Canonicalizing the Server-Side Path Name) s
5 624 M
(   The SSH_FXP_REALPATH request can be used to have the server) s
5 613 M
(   canonicalize any given path name to an absolute path.  This is useful) s
5 602 M
(   for converting path names containing ".." components or relative) s
5 591 M
(   pathnames without a leading slash into absolute paths.  The format of) s
5 580 M
(   the request is as follows:) s
5 558 M
(        uint32     id) s
5 547 M
(        string     path [UTF-8]) s
5 525 M
(   where `id' is the request identifier and `path' specifies the path) s
5 514 M
(   name to be canonicalized.  The server will respond with a) s
5 503 M
(   SSH_FXP_NAME packet containing the name in canonical form and a dummy) s
5 492 M
(   attributes value.  If an error occurs, the server may also respond) s
5 481 M
(   with SSH_FXP_STATUS.) s
5 459 M
(6.11.1 Best practice for dealing with paths) s
5 437 M
(   The client SHOULD treat the results of SSH_FXP_REALPATH as a) s
5 426 M
(   canonical absolute path, even if the path does not appear to be) s
5 415 M
(   absolute.  A client that use REALPATH\("."\) and treats the result as) s
5 404 M
(   absolute, even if there is no leading slash, will continue to) s
5 393 M
(   function correctly, even when talking to a Windows NT or VMS style) s
5 382 M
(   system, where absolute paths may not begin with a slash.) s
5 360 M
(   For example, if the client wishes to change directory up, and the) s
5 349 M
(   server has returned "c:/x/y/z" from REALPATH, the client SHOULD use) s
5 338 M
(   "c:/x/y/z/..".) s
5 316 M
(   As a second example, if the client wishes to open the file "x.txt" in) s
5 305 M
(   the current directory, and server has returned "dka100:/x/y/z" as the) s
5 294 M
(   canonical path of the directory, the client SHOULD open "dka100:/x/y/) s
5 283 M
(   z/x.txt") s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 23]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 24 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(7. Responses from the Server to the Client) s
5 668 M
(   The server responds to the client using one of a few response) s
5 657 M
(   packets.  All requests can return a SSH_FXP_STATUS response upon) s
5 646 M
(   failure.  When the operation is successful, any of the responses may) s
5 635 M
(   be returned \(depending on the operation\).  If no data needs to be) s
5 624 M
(   returned to the client, the SSH_FXP_STATUS response with SSH_FX_OK) s
5 613 M
(   status is appropriate.  Otherwise, the SSH_FXP_HANDLE message is used) s
5 602 M
(   to return a file handle \(for SSH_FXP_OPEN and SSH_FXP_OPENDIR) s
5 591 M
(   requests\), SSH_FXP_DATA is used to return data from SSH_FXP_READ,) s
5 580 M
(   SSH_FXP_NAME is used to return one or more file names from a) s
5 569 M
(   SSH_FXP_READDIR or SSH_FXP_REALPATH request, and SSH_FXP_ATTRS is) s
5 558 M
(   used to return file attributes from SSH_FXP_STAT, SSH_FXP_LSTAT, and) s
5 547 M
(   SSH_FXP_FSTAT requests.) s
5 525 M
(   Exactly one response will be returned for each request.  Each) s
5 514 M
(   response packet contains a request identifier which can be used to) s
5 503 M
(   match each response with the corresponding request.  Note that it is) s
5 492 M
(   legal to have several requests outstanding simultaneously, and the) s
5 481 M
(   server is allowed to send responses to them in a different order from) s
5 470 M
(   the order in which the requests were sent \(the result of their) s
5 459 M
(   execution, however, is guaranteed to be as if they had been processed) s
5 448 M
(   one at a time in the order in which the requests were sent\).) s
5 426 M
(   Response packets are of the same general format as request packets.) s
5 415 M
(   Each response packet begins with the request identifier.) s
5 393 M
(   The format of the data portion of the SSH_FXP_STATUS response is as) s
5 382 M
(   follows:) s
5 360 M
(        uint32     id) s
5 349 M
(        uint32     error/status code) s
5 338 M
(        string     error message \(ISO-10646 UTF-8 [RFC-2279]\)) s
5 327 M
(        string     language tag \(as defined in [RFC-1766]\)) s
5 305 M
(   where `id' is the request identifier, and `error/status code') s
5 294 M
(   indicates the result of the requested operation.  The value SSH_FX_OK) s
5 283 M
(   indicates success, and all other values indicate failure.) s
5 261 M
(   Currently, the following values are defined \(other values may be) s
5 250 M
(   defined by future versions of this protocol\):) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 24]) s
_R
S
PStoPSsaved restore
%%Page: (24,25) 13
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 25 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(        #define SSH_FX_OK                            0) s
5 679 M
(        #define SSH_FX_EOF                           1) s
5 668 M
(        #define SSH_FX_NO_SUCH_FILE                  2) s
5 657 M
(        #define SSH_FX_PERMISSION_DENIED             3) s
5 646 M
(        #define SSH_FX_FAILURE                       4) s
5 635 M
(        #define SSH_FX_BAD_MESSAGE                   5) s
5 624 M
(        #define SSH_FX_NO_CONNECTION                 6) s
5 613 M
(        #define SSH_FX_CONNECTION_LOST               7) s
5 602 M
(        #define SSH_FX_OP_UNSUPPORTED                8) s
5 591 M
(        #define SSH_FX_INVALID_HANDLE                9) s
5 580 M
(        #define SSH_FX_NO_SUCH_PATH                  10) s
5 569 M
(        #define SSH_FX_FILE_ALREADY_EXISTS                       11) s
5 558 M
(        #define SSH_FX_WRITE_PROTECT                             12) s
5 536 M
(   SSH_FX_OK) s
5 525 M
(      Indicates successful completion of the operation.) s
5 503 M
(   SSH_FX_EOF) s
5 492 M
(      indicates end-of-file condition; for SSH_FX_READ it means that no) s
5 481 M
(      more data is available in the file, and for SSH_FX_READDIR it) s
5 470 M
(      indicates that no more files are contained in the directory.) s
5 448 M
(   SSH_FX_NO_SUCH_FILE) s
5 437 M
(      is returned when a reference is made to a file which does not) s
5 426 M
(      exist.) s
5 404 M
(   SSH_FX_PERMISSION_DENIED) s
5 393 M
(      is returned when the authenticated user does not have sufficient) s
5 382 M
(      permissions to perform the operation.) s
5 360 M
(   SSH_FX_FAILURE) s
5 349 M
(      is a generic catch-all error message; it should be returned if an) s
5 338 M
(      error occurs for which there is no more specific error code) s
5 327 M
(      defined.) s
5 305 M
(   SSH_FX_BAD_MESSAGE) s
5 294 M
(      may be returned if a badly formatted packet or protocol) s
5 283 M
(      incompatibility is detected.) s
5 261 M
(   SSH_FX_NO_CONNECTION) s
5 250 M
(      is a pseudo-error which indicates that the client has no) s
5 239 M
(      connection to the server \(it can only be generated locally by the) s
5 228 M
(      client, and MUST NOT be returned by servers\).) s
5 206 M
(   SSH_FX_CONNECTION_LOST) s
5 195 M
(      is a pseudo-error which indicates that the connection to the) s
5 184 M
(      server has been lost \(it can only be generated locally by the) s
5 173 M
(      client, and MUST NOT be returned by servers\).) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 25]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 26 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(   SSH_FX_OP_UNSUPPORTED) s
5 679 M
(      indicates that an attempt was made to perform an operation which) s
5 668 M
(      is not supported for the server \(it may be generated locally by) s
5 657 M
(      the client if e.g.  the version number exchange indicates that a) s
5 646 M
(      required feature is not supported by the server, or it may be) s
5 635 M
(      returned by the server if the server does not implement an) s
5 624 M
(      operation\).) s
5 602 M
(   SSH_FX_INVALID_HANDLE) s
5 591 M
(      The handle value was invalid.) s
5 569 M
(   SSH_FX_NO_SUCH_PATH) s
5 558 M
(      The file path does not exist or is invalid.) s
5 536 M
(   SSH_FX_FILE_ALREADY_EXISTS) s
5 525 M
(      The file already exists.) s
5 503 M
(   SSH_FX_WRITE_PROTECT) s
5 492 M
(      The file is on read only media, or the media is write protected.) s
5 470 M
(   The SSH_FXP_HANDLE response has the following format:) s
5 448 M
(        uint32     id) s
5 437 M
(        string     handle) s
5 415 M
(   where `id' is the request identifier, and `handle' is an arbitrary) s
5 404 M
(   string that identifies an open file or directory on the server.  The) s
5 393 M
(   handle is opaque to the client; the client MUST NOT attempt to) s
5 382 M
(   interpret or modify it in any way.  The length of the handle string) s
5 371 M
(   MUST NOT exceed 256 data bytes.) s
5 349 M
(   The SSH_FXP_DATA response has the following format:) s
5 327 M
(        uint32     id) s
5 316 M
(        string     data) s
5 294 M
(   where `id' is the request identifier, and `data' is an arbitrary byte) s
5 283 M
(   string containing the requested data.  The data string may be at most) s
5 272 M
(   the number of bytes requested in a SSH_FXP_READ request, but may also) s
5 261 M
(   be shorter if end of file is reached or if the read is from something) s
5 250 M
(   other than a regular file.) s
5 228 M
(   The SSH_FXP_NAME response has the following format:) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 26]) s
_R
S
PStoPSsaved restore
%%Page: (26,27) 14
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 27 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(        uint32     id) s
5 679 M
(        uint32     count) s
5 668 M
(        repeats count times:) s
5 657 M
(                string     filename [UTF-8]) s
5 646 M
(                ATTRS      attrs) s
5 624 M
(   where `id' is the request identifier, `count' is the number of names) s
5 613 M
(   returned in this response, and the remaining fields repeat `count') s
5 602 M
(   times \(so that all three fields are first included for the first) s
5 591 M
(   file, then for the second file, etc\).  In the repeated part,) s
5 580 M
(   `filename' is a file name being returned \(for SSH_FXP_READDIR, it) s
5 569 M
(   will be a relative name within the directory, without any path) s
5 558 M
(   components; for SSH_FXP_REALPATH it will be an absolute path name\),) s
5 547 M
(   and `attrs' is the attributes of the file as described in Section) s
5 536 M
(   ``File Attributes''.) s
5 514 M
(   The SSH_FXP_ATTRS response has the following format:) s
5 492 M
(        uint32     id) s
5 481 M
(        ATTRS      attrs) s
5 459 M
(   where `id' is the request identifier, and `attrs' is the returned) s
5 448 M
(   file attributes as described in Section ``File Attributes''.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 27]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 28 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(8. Vendor-Specific Extensions) s
5 668 M
(   The SSH_FXP_EXTENDED request provides a generic extension mechanism) s
5 657 M
(   for adding vendor-specific commands.  The request has the following) s
5 646 M
(   format:) s
5 624 M
(        uint32     id) s
5 613 M
(        string     extended-request) s
5 602 M
(        ... any request-specific data ...) s
5 580 M
(   where `id' is the request identifier, and `extended-request' is a) s
5 569 M
(   string of the format "name@domain", where domain is an internet) s
5 558 M
(   domain name of the vendor defining the request.  The rest of the) s
5 547 M
(   request is completely vendor-specific, and servers should only) s
5 536 M
(   attempt to interpret it if they recognize the `extended-request') s
5 525 M
(   name.) s
5 503 M
(   The server may respond to such requests using any of the response) s
5 492 M
(   packets defined in Section ``Responses from the Server to the) s
5 481 M
(   Client''.  Additionally, the server may also respond with a) s
5 470 M
(   SSH_FXP_EXTENDED_REPLY packet, as defined below.  If the server does) s
5 459 M
(   not recognize the `extended-request' name, then the server MUST) s
5 448 M
(   respond with SSH_FXP_STATUS with error/status set to) s
5 437 M
(   SSH_FX_OP_UNSUPPORTED.) s
5 415 M
(   The SSH_FXP_EXTENDED_REPLY packet can be used to carry arbitrary) s
5 404 M
(   extension-specific data from the server to the client.  It is of the) s
5 393 M
(   following format:) s
5 371 M
(        uint32     id) s
5 360 M
(        ... any request-specific data ...) s
5 338 M
(   There is a range of packet types reserved for use by extensions.  In) s
5 327 M
(   order to avoid collision, extensions that turn on the use of) s
5 316 M
(   additional packet types should determine those numbers dynamically.) s
5 294 M
(   The suggested way of doing this is have an extension request from the) s
5 283 M
(   client to the server that enables the extension; the extension) s
5 272 M
(   response from the server to the client would specify the actual type) s
5 261 M
(   values to use, in additional to any other data.) s
5 239 M
(   Extension authors should be mindful of the limited range of packet) s
5 228 M
(   types available \(there are only 45 values available\) and avoid) s
5 217 M
(   requiring a new packet type where possible.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 28]) s
_R
S
PStoPSsaved restore
%%Page: (28,29) 15
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 29 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(9. Security Considerations) s
5 668 M
(   This protocol assumes that it is run over a secure channel and that) s
5 657 M
(   the endpoints of the channel have been authenticated.  Thus, this) s
5 646 M
(   protocol assumes that it is externally protected from network-level) s
5 635 M
(   attacks.) s
5 613 M
(   This protocol provides file system access to arbitrary files on the) s
5 602 M
(   server \(only constrained by the server implementation\).  It is the) s
5 591 M
(   responsibility of the server implementation to enforce any access) s
5 580 M
(   controls that may be required to limit the access allowed for any) s
5 569 M
(   particular user \(the user being authenticated externally to this) s
5 558 M
(   protocol, typically using the SSH User Authentication Protocol [8].) s
5 536 M
(   Care must be taken in the server implementation to check the validity) s
5 525 M
(   of received file handle strings.  The server should not rely on them) s
5 514 M
(   directly; it MUST check the validity of each handle before relying on) s
5 503 M
(   it.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 29]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 30 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(10. Changes from previous protocol versions) s
5 668 M
(   The SSH File Transfer Protocol has changed over time, before it's) s
5 657 M
(   standardization.  The following is a description of the incompatible) s
5 646 M
(   changes between different versions.) s
5 624 M
(10.1 Changes between versions 4 and 3) s
5 602 M
(   Many of the changes between version 4 and version 3 are to the) s
5 591 M
(   attribute structure to make it more flexible for non-unix platforms.) s
5 569 M
(   o  Make all filenames UTF-8.) s
5 547 M
(   o  Added 'newline' extension.) s
5 525 M
(   o  Made file attribute owner and group strings so they can actually) s
5 514 M
(      be used on disparate systems.) s
5 492 M
(   o  Added createtime field, and added separate flags for atime,) s
5 481 M
(      createtime, and mtime so they can be set separately.) s
5 459 M
(   o  Split the file type out of the permissions field and into it's own) s
5 448 M
(      field \(which is always present.\)) s
5 426 M
(   o  Added acl attribute.) s
5 404 M
(   o  Added SSH_FXF_TEXT file open flag.) s
5 382 M
(   o  Added flags field to the get stat commands so that the client can) s
5 371 M
(      specifically request information the server might not normally) s
5 360 M
(      included for performance reasons.) s
5 338 M
(   o  Removed the long filename from the names structure-- it can now be) s
5 327 M
(      built from information available in the attrs structure.) s
5 305 M
(   o  Added reserved range of packet numbers for extensions.) s
5 283 M
(   o  Added several additional error codes.) s
5 261 M
(   o  Change the way version negotiate works slightly.  Previously, if) s
5 250 M
(      the client version were higher than the server version, the server) s
5 239 M
(      was supposed to 'echo back' the clients version.  The server now) s
5 228 M
(      sends it's own version and the lower of the two is considered to) s
5 217 M
(      be the one in use.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 30]) s
_R
S
PStoPSsaved restore
%%Page: (30,31) 16
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 31 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(10.2 Changes between versions 3 and 2) s
5 668 M
(   o  The SSH_FXP_READLINK and SSH_FXP_SYMLINK messages were added.) s
5 646 M
(   o  The SSH_FXP_EXTENDED and SSH_FXP_EXTENDED_REPLY messages were) s
5 635 M
(      added.) s
5 613 M
(   o  The SSH_FXP_STATUS message was changed to include fields `error) s
5 602 M
(      message' and `language tag'.) s
5 569 M
(10.3 Changes between versions 2 and 1) s
5 547 M
(   o  The SSH_FXP_RENAME message was added.) s
5 514 M
(10.4 Changes between versions 1 and 0) s
5 492 M
(   o  Implementation changes, no actual protocol changes.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 31]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 32 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(11. Trademark Issues) s
5 668 M
(   "ssh" is a registered trademark of SSH Communications Security Corp) s
5 657 M
(   in the United States and/or other countries.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 32]) s
_R
S
PStoPSsaved restore
%%Page: (32,33) 17
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 33 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(References) s
5 668 M
(   [1]  Dierks, T., Allen, C., Treese, W., Karlton, P., Freier, A. and) s
5 657 M
(        P. Kocher, "The TLS Protocol Version 1.0", RFC 2246, January) s
5 646 M
(        1999.) s
5 624 M
(   [2]  Alvestrand, H., "IETF Policy on Character Sets and Languages",) s
5 613 M
(        BCP 18, RFC 2277, January 1998.) s
5 591 M
(   [3]  Shepler, S., Callaghan, B., Robinson, D., Thurlow, R., Beame,) s
5 580 M
(        C., Eisler, M. and D. Noveck, "NFS version 4 Protocol", RFC) s
5 569 M
(        3010, December 2000.) s
5 547 M
(   [4]  Institute of Electrical and Electronics Engineers, "Information) s
5 536 M
(        Technology - Portable Operating System Interface \(POSIX\) - Part) s
5 525 M
(        1: System Application Program Interface \(API\) [C Language]",) s
5 514 M
(        IEEE Standard 1003.2, 1996.) s
5 492 M
(   [5]  Rinne, T., Ylonen, T., Kivinen, T., Saarinen, M. and S.) s
5 481 M
(        Lehtinen, "SSH Protocol Architecture", draft-ietf-secsh-) s
5 470 M
(        architecture-13 \(work in progress\), September 2002.) s
5 448 M
(   [6]  Rinne, T., Ylonen, T., Kivinen, T., Saarinen, M. and S.) s
5 437 M
(        Lehtinen, "SSH Protocol Transport Protocol", draft-ietf-secsh-) s
5 426 M
(        transport-15 \(work in progress\), September 2002.) s
5 404 M
(   [7]  Rinne, T., Ylonen, T., Kivinen, T., Saarinen, M. and S.) s
5 393 M
(        Lehtinen, "SSH Connection Protocol", draft-ietf-secsh-connect-16) s
5 382 M
(        \(work in progress\), September 2002.) s
5 360 M
(   [8]  Rinne, T., Ylonen, T., Kivinen, T., Saarinen, M. and S.) s
5 349 M
(        Lehtinen, "SSH Authentication Protocol", draft-ietf-secsh-) s
5 338 M
(        userauth-16 \(work in progress\), September 2002.) s
5 305 M
(Authors' Addresses) s
5 283 M
(   Joseph Galbraith) s
5 272 M
(   VanDyke Software) s
5 261 M
(   4848 Tramway Ridge Blvd) s
5 250 M
(   Suite 101) s
5 239 M
(   Albuquerque, NM  87111) s
5 228 M
(   US) s
5 206 M
(   Phone: +1 505 332 5700) s
5 195 M
(   EMail: [email protected]) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 33]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 34 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(   Tatu Ylonen) s
5 679 M
(   SSH Communications Security Corp) s
5 668 M
(   Fredrikinkatu 42) s
5 657 M
(   HELSINKI  FIN-00100) s
5 646 M
(   Finland) s
5 624 M
(   EMail: [email protected]) s
5 591 M
(   Sami Lehtinen) s
5 580 M
(   SSH Communications Security Corp) s
5 569 M
(   Fredrikinkatu 42) s
5 558 M
(   HELSINKI  FIN-00100) s
5 547 M
(   Finland) s
5 525 M
(   EMail: [email protected]) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 34]) s
_R
S
PStoPSsaved restore
%%Page: (34,35) 18
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 0.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
/showpage{}def/copypage{}def/erasepage{}def
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 35 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
5 723 M
(Internet-Draft         SSH File Transfer Protocol           October 2002) s
5 690 M
(Full Copyright Statement) s
5 668 M
(   Copyright \(C\) The Internet Society \(2002\).  All Rights Reserved.) s
5 646 M
(   This document and translations of it may be copied and furnished to) s
5 635 M
(   others, and derivative works that comment on or otherwise explain it) s
5 624 M
(   or assist in its implementation may be prepared, copied, published) s
5 613 M
(   and distributed, in whole or in part, without restriction of any) s
5 602 M
(   kind, provided that the above copyright notice and this paragraph are) s
5 591 M
(   included on all such copies and derivative works.  However, this) s
5 580 M
(   document itself may not be modified in any way, such as by removing) s
5 569 M
(   the copyright notice or references to the Internet Society or other) s
5 558 M
(   Internet organizations, except as needed for the purpose of) s
5 547 M
(   developing Internet standards in which case the procedures for) s
5 536 M
(   copyrights defined in the Internet Standards process must be) s
5 525 M
(   followed, or as required to translate it into languages other than) s
5 514 M
(   English.) s
5 492 M
(   The limited permissions granted above are perpetual and will not be) s
5 481 M
(   revoked by the Internet Society or its successors or assigns.) s
5 459 M
(   This document and the information contained herein is provided on an) s
5 448 M
(   "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING) s
5 437 M
(   TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING) s
5 426 M
(   BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION) s
5 415 M
(   HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF) s
5 404 M
(   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.) s
5 382 M
(Acknowledgement) s
5 360 M
(   Funding for the RFC Editor function is currently provided by the) s
5 349 M
(   Internet Society.) s
5 129 M
(Galbraith, et al.        Expires April 16, 2003                [Page 35]) s
_R
S
PStoPSsaved restore
userdict/PStoPSsaved save put
PStoPSmatrix setmatrix
595.000000 421.271378 translate
90 rotate
0.706651 dup scale
userdict/PStoPSmatrix matrix currentmatrix put
userdict/PStoPSclip{0 0 moveto
 595.000000 0 rlineto 0 842.000000 rlineto -595.000000 0 rlineto
 closepath}put initclip
PStoPSxform concat
%%BeginPageSetup
_S
75 0 translate
/pagenum 36 def
/fname () def
/fdir () def
/ftail () def
/user_header_p false def
%%EndPageSetup
_R
S
PStoPSsaved restore
%%Trailer
%%Pages: 36
%%DocumentNeededResources: font Courier-Bold Courier 
%%EOF