2 * sftp.c: SFTP generic client code.
13 #define smalloc malloc
14 #define srealloc realloc
17 #define GET_32BIT(cp) \
18 (((unsigned long)(unsigned char)(cp)[0] << 24) | \
19 ((unsigned long)(unsigned char)(cp)[1] << 16) | \
20 ((unsigned long)(unsigned char)(cp)[2] << 8) | \
21 ((unsigned long)(unsigned char)(cp)[3]))
23 #define PUT_32BIT(cp, value) { \
24 (cp)[0] = (unsigned char)((value) >> 24); \
25 (cp)[1] = (unsigned char)((value) >> 16); \
26 (cp)[2] = (unsigned char)((value) >> 8); \
27 (cp)[3] = (unsigned char)(value); }
36 /* ----------------------------------------------------------------------
37 * SFTP packet construction functions.
39 static void sftp_pkt_ensure(struct sftp_packet
*pkt
, int length
) {
40 if (pkt
->maxlen
< length
) {
41 pkt
->maxlen
= length
+ 256;
42 pkt
->data
= srealloc(pkt
->data
, pkt
->maxlen
);
45 static void sftp_pkt_adddata(struct sftp_packet
*pkt
, void *data
, int len
) {
47 sftp_pkt_ensure(pkt
, pkt
->length
);
48 memcpy(pkt
->data
+pkt
->length
-len
, data
, len
);
50 static void sftp_pkt_addbyte(struct sftp_packet
*pkt
, unsigned char byte
) {
51 sftp_pkt_adddata(pkt
, &byte
, 1);
53 static struct sftp_packet
*sftp_pkt_init(int pkt_type
) {
54 struct sftp_packet
*pkt
;
55 pkt
= smalloc(sizeof(struct sftp_packet
));
60 sftp_pkt_addbyte(pkt
, (unsigned char)pkt_type
);
63 static void sftp_pkt_addbool(struct sftp_packet
*pkt
, unsigned char value
) {
64 sftp_pkt_adddata(pkt
, &value
, 1);
66 static void sftp_pkt_adduint32(struct sftp_packet
*pkt
, unsigned long value
) {
69 sftp_pkt_adddata(pkt
, x
, 4);
71 static void sftp_pkt_adduint64(struct sftp_packet
*pkt
, uint64 value
) {
73 PUT_32BIT(x
, value
.hi
);
74 PUT_32BIT(x
+4, value
.lo
);
75 sftp_pkt_adddata(pkt
, x
, 8);
77 static void sftp_pkt_addstring_start(struct sftp_packet
*pkt
) {
78 sftp_pkt_adduint32(pkt
, 0);
79 pkt
->savedpos
= pkt
->length
;
81 static void sftp_pkt_addstring_str(struct sftp_packet
*pkt
, char *data
) {
82 sftp_pkt_adddata(pkt
, data
, strlen(data
));
83 PUT_32BIT(pkt
->data
+ pkt
->savedpos
- 4,
84 pkt
->length
- pkt
->savedpos
);
86 static void sftp_pkt_addstring_data(struct sftp_packet
*pkt
,
87 char *data
, int len
) {
88 sftp_pkt_adddata(pkt
, data
, len
);
89 PUT_32BIT(pkt
->data
+ pkt
->savedpos
- 4,
90 pkt
->length
- pkt
->savedpos
);
92 static void sftp_pkt_addstring(struct sftp_packet
*pkt
, char *data
) {
93 sftp_pkt_addstring_start(pkt
);
94 sftp_pkt_addstring_str(pkt
, data
);
97 /* ----------------------------------------------------------------------
98 * SFTP packet decode functions.
101 static unsigned char sftp_pkt_getbyte(struct sftp_packet
*pkt
) {
103 if (pkt
->length
- pkt
->savedpos
< 1)
104 return 0; /* arrgh, no way to decline (FIXME?) */
105 value
= (unsigned char) pkt
->data
[pkt
->savedpos
];
109 static unsigned long sftp_pkt_getuint32(struct sftp_packet
*pkt
) {
111 if (pkt
->length
- pkt
->savedpos
< 4)
112 return 0; /* arrgh, no way to decline (FIXME?) */
113 value
= GET_32BIT(pkt
->data
+pkt
->savedpos
);
117 static void sftp_pkt_getstring(struct sftp_packet
*pkt
,
118 char **p
, int *length
) {
120 if (pkt
->length
- pkt
->savedpos
< 4)
122 *length
= GET_32BIT(pkt
->data
+pkt
->savedpos
);
124 if (pkt
->length
- pkt
->savedpos
< *length
)
126 *p
= pkt
->data
+pkt
->savedpos
;
127 pkt
->savedpos
+= *length
;
129 static struct fxp_attrs
sftp_pkt_getattrs(struct sftp_packet
*pkt
) {
130 struct fxp_attrs ret
;
131 ret
.flags
= sftp_pkt_getuint32(pkt
);
132 if (ret
.flags
& SSH_FILEXFER_ATTR_SIZE
) {
133 unsigned long hi
, lo
;
134 hi
= sftp_pkt_getuint32(pkt
);
135 lo
= sftp_pkt_getuint32(pkt
);
136 ret
.size
= uint64_make(hi
, lo
);
138 if (ret
.flags
& SSH_FILEXFER_ATTR_UIDGID
) {
139 ret
.uid
= sftp_pkt_getuint32(pkt
);
140 ret
.gid
= sftp_pkt_getuint32(pkt
);
142 if (ret
.flags
& SSH_FILEXFER_ATTR_PERMISSIONS
) {
143 ret
.permissions
= sftp_pkt_getuint32(pkt
);
145 if (ret
.flags
& SSH_FILEXFER_ATTR_ACMODTIME
) {
146 ret
.atime
= sftp_pkt_getuint32(pkt
);
147 ret
.mtime
= sftp_pkt_getuint32(pkt
);
149 if (ret
.flags
& SSH_FILEXFER_ATTR_EXTENDED
) {
151 count
= sftp_pkt_getuint32(pkt
);
156 * We should try to analyse these, if we ever find one
159 sftp_pkt_getstring(pkt
, &str
, &len
);
160 sftp_pkt_getstring(pkt
, &str
, &len
);
165 static void sftp_pkt_free(struct sftp_packet
*pkt
) {
166 if (pkt
->data
) sfree(pkt
->data
);
170 /* ----------------------------------------------------------------------
171 * Send and receive packet functions. FIXME: change for PuTTY.
178 assert(pipe(to
) == 0);
179 assert(pipe(from
) == 0);
183 /* We are child. Dup one end of each pipe to our std[io],
184 * close other end, exec. */
185 close(0); dup2(to
[0], 0); close(to
[1]);
186 close(1); dup2(from
[1], 1); close(from
[0]);
187 execl("/home/simon/src/openssh/openssh_cvs/prefix/bin/ssh", "ssh", "-2", "simon@localhost", "-s", "sftp", NULL
);
188 assert(0); /* bomb out if not */
190 /* We are parent. Close wrong end of each pipe, assign to glob vars. */
191 close(to
[0]); tossh
= to
[1];
192 close(from
[1]); fromssh
= from
[0];
195 int io_finish(void) {
201 int sftp_send(struct sftp_packet
*pkt
) {
203 PUT_32BIT(x
, pkt
->length
);
204 assert(4 == write(tossh
, x
, 4));
205 assert(pkt
->length
= write(tossh
, pkt
->data
, pkt
->length
));
208 struct sftp_packet
*sftp_recv(void) {
209 struct sftp_packet
*pkt
;
213 for (p
= 0; p
< 4 ;) {
214 ret
= read(fromssh
, x
+p
, 4-p
);
221 pkt
= smalloc(sizeof(struct sftp_packet
));
223 pkt
->length
= pkt
->maxlen
= GET_32BIT(x
);
224 pkt
->data
= smalloc(pkt
->length
);
226 for (p
= 0; p
< pkt
->length
;) {
227 ret
= read(fromssh
, pkt
->data
+p
, pkt
->length
-p
);
236 pkt
->type
= sftp_pkt_getbyte(pkt
);
241 /* ----------------------------------------------------------------------
242 * String handling routines.
245 static char *mkstr(char *s
, int len
) {
246 char *p
= smalloc(len
+1);
252 /* ----------------------------------------------------------------------
256 static const char *fxp_error_message
;
257 static int fxp_errtype
;
260 * Deal with (and free) an FXP_STATUS packet. Return 1 if
261 * SSH_FX_OK, 0 if SSH_FX_EOF, and -1 for anything else (error).
262 * Also place the status into fxp_errtype.
264 static int fxp_got_status(struct sftp_packet
*pktin
) {
265 static const char *const messages
[] = {
266 /* SSH_FX_OK. The only time we will display a _message_ for this
267 * is if we were expecting something other than FXP_STATUS on
268 * success, so this is actually an error message! */
269 "unexpected OK response",
271 "no such file or directory",
277 "operation unsupported",
280 if (pktin
->type
!= SSH_FXP_STATUS
) {
281 fxp_error_message
= "expected FXP_STATUS packet";
284 fxp_errtype
= sftp_pkt_getuint32(pktin
);
285 if (fxp_errtype
< 0 ||
286 fxp_errtype
>= sizeof(messages
)/sizeof(*messages
))
287 fxp_error_message
= "unknown error code";
289 fxp_error_message
= messages
[fxp_errtype
];
292 if (fxp_errtype
== SSH_FX_OK
)
294 else if (fxp_errtype
== SSH_FX_EOF
)
300 static int fxp_internal_error(char *msg
) {
301 fxp_error_message
= msg
;
305 const char *fxp_error(void) {
306 return fxp_error_message
;
309 int fxp_error_type(void) {
314 * Perform exchange of init/version packets. Return 0 on failure.
317 struct sftp_packet
*pktout
, *pktin
;
320 pktout
= sftp_pkt_init(SSH_FXP_INIT
);
321 sftp_pkt_adduint32(pktout
, SFTP_PROTO_VERSION
);
325 if (pktin
->type
!= SSH_FXP_VERSION
) {
326 fxp_internal_error("did not receive FXP_VERSION");
329 remotever
= sftp_pkt_getuint32(pktin
);
330 if (remotever
> SFTP_PROTO_VERSION
) {
331 fxp_internal_error("remote protocol is more advanced than we support");
335 * In principle, this packet might also contain extension-
336 * string pairs. We should work through them and look for any
337 * we recognise. In practice we don't currently do so because
338 * we know we don't recognise _any_.
340 sftp_pkt_free(pktin
);
346 * Canonify a pathname. Concatenate the two given path elements
347 * with a separating slash, unless the second is NULL.
349 char *fxp_realpath(char *path
, char *path2
) {
350 struct sftp_packet
*pktin
, *pktout
;
353 pktout
= sftp_pkt_init(SSH_FXP_REALPATH
);
354 sftp_pkt_adduint32(pktout
, 0x123); /* request id */
355 sftp_pkt_addstring_start(pktout
);
356 sftp_pkt_addstring_str(pktout
, path
);
358 sftp_pkt_addstring_str(pktout
, "/");
359 sftp_pkt_addstring_str(pktout
, path2
);
363 id
= sftp_pkt_getuint32(pktin
);
365 fxp_internal_error("request ID mismatch\n");
368 if (pktin
->type
== SSH_FXP_NAME
) {
373 count
= sftp_pkt_getuint32(pktin
);
375 fxp_internal_error("REALPATH returned name count != 1\n");
378 sftp_pkt_getstring(pktin
, &path
, &len
);
380 fxp_internal_error("REALPATH returned malformed FXP_NAME\n");
383 path
= mkstr(path
, len
);
384 sftp_pkt_free(pktin
);
387 fxp_got_status(pktin
);
395 struct fxp_handle
*fxp_open(char *path
, int type
) {
396 struct sftp_packet
*pktin
, *pktout
;
399 pktout
= sftp_pkt_init(SSH_FXP_OPEN
);
400 sftp_pkt_adduint32(pktout
, 0x567); /* request id */
401 sftp_pkt_addstring(pktout
, path
);
402 sftp_pkt_adduint32(pktout
, type
);
403 sftp_pkt_adduint32(pktout
, 0); /* (FIXME) empty ATTRS structure */
406 id
= sftp_pkt_getuint32(pktin
);
408 fxp_internal_error("request ID mismatch\n");
411 if (pktin
->type
== SSH_FXP_HANDLE
) {
414 struct fxp_handle
*handle
;
417 sftp_pkt_getstring(pktin
, &hstring
, &len
);
419 fxp_internal_error("OPEN returned malformed FXP_HANDLE\n");
422 handle
= smalloc(sizeof(struct fxp_handle
));
423 handle
->hstring
= mkstr(hstring
, len
);
424 sftp_pkt_free(pktin
);
427 fxp_got_status(pktin
);
435 struct fxp_handle
*fxp_opendir(char *path
) {
436 struct sftp_packet
*pktin
, *pktout
;
439 pktout
= sftp_pkt_init(SSH_FXP_OPENDIR
);
440 sftp_pkt_adduint32(pktout
, 0x456); /* request id */
441 sftp_pkt_addstring(pktout
, path
);
444 id
= sftp_pkt_getuint32(pktin
);
446 fxp_internal_error("request ID mismatch\n");
449 if (pktin
->type
== SSH_FXP_HANDLE
) {
452 struct fxp_handle
*handle
;
455 sftp_pkt_getstring(pktin
, &hstring
, &len
);
457 fxp_internal_error("OPENDIR returned malformed FXP_HANDLE\n");
460 handle
= smalloc(sizeof(struct fxp_handle
));
461 handle
->hstring
= mkstr(hstring
, len
);
462 sftp_pkt_free(pktin
);
465 fxp_got_status(pktin
);
473 void fxp_close(struct fxp_handle
*handle
) {
474 struct sftp_packet
*pktin
, *pktout
;
477 pktout
= sftp_pkt_init(SSH_FXP_CLOSE
);
478 sftp_pkt_adduint32(pktout
, 0x789); /* request id */
479 sftp_pkt_addstring(pktout
, handle
->hstring
);
482 id
= sftp_pkt_getuint32(pktin
);
484 fxp_internal_error("request ID mismatch\n");
487 fxp_got_status(pktin
);
488 sfree(handle
->hstring
);
493 * Read from a file. Returns the number of bytes read, or -1 on an
494 * error, or possibly 0 if EOF. (I'm not entirely sure whether it
495 * will return 0 on EOF, or return -1 and store SSH_FX_EOF in the
496 * error indicator. It might even depend on the SFTP server.)
498 int fxp_read(struct fxp_handle
*handle
, char *buffer
, uint64 offset
, int len
) {
499 struct sftp_packet
*pktin
, *pktout
;
502 pktout
= sftp_pkt_init(SSH_FXP_READ
);
503 sftp_pkt_adduint32(pktout
, 0xBCD); /* request id */
504 sftp_pkt_addstring(pktout
, handle
->hstring
);
505 sftp_pkt_adduint64(pktout
, offset
);
506 sftp_pkt_adduint32(pktout
, len
);
509 id
= sftp_pkt_getuint32(pktin
);
511 fxp_internal_error("request ID mismatch");
514 if (pktin
->type
== SSH_FXP_DATA
) {
518 sftp_pkt_getstring(pktin
, &str
, &rlen
);
520 if (rlen
> len
|| rlen
< 0) {
521 fxp_internal_error("READ returned more bytes than requested");
525 memcpy(buffer
, str
, rlen
);
529 fxp_got_status(pktin
);
535 * Read from a directory.
537 struct fxp_names
*fxp_readdir(struct fxp_handle
*handle
) {
538 struct sftp_packet
*pktin
, *pktout
;
541 pktout
= sftp_pkt_init(SSH_FXP_READDIR
);
542 sftp_pkt_adduint32(pktout
, 0xABC); /* request id */
543 sftp_pkt_addstring(pktout
, handle
->hstring
);
546 id
= sftp_pkt_getuint32(pktin
);
548 fxp_internal_error("request ID mismatch\n");
551 if (pktin
->type
== SSH_FXP_NAME
) {
552 struct fxp_names
*ret
;
554 ret
= smalloc(sizeof(struct fxp_names
));
555 ret
->nnames
= sftp_pkt_getuint32(pktin
);
556 ret
->names
= smalloc(ret
->nnames
* sizeof(struct fxp_name
));
557 for (i
= 0; i
< ret
->nnames
; i
++) {
560 sftp_pkt_getstring(pktin
, &str
, &len
);
561 ret
->names
[i
].filename
= mkstr(str
, len
);
562 sftp_pkt_getstring(pktin
, &str
, &len
);
563 ret
->names
[i
].longname
= mkstr(str
, len
);
564 ret
->names
[i
].attrs
= sftp_pkt_getattrs(pktin
);
568 fxp_got_status(pktin
);
574 * Write to a file. Returns 0 on error, 1 on OK.
576 int fxp_write(struct fxp_handle
*handle
, char *buffer
, uint64 offset
, int len
) {
577 struct sftp_packet
*pktin
, *pktout
;
580 pktout
= sftp_pkt_init(SSH_FXP_WRITE
);
581 sftp_pkt_adduint32(pktout
, 0xDCB); /* request id */
582 sftp_pkt_addstring(pktout
, handle
->hstring
);
583 sftp_pkt_adduint64(pktout
, offset
);
584 sftp_pkt_addstring_start(pktout
);
585 sftp_pkt_addstring_data(pktout
, buffer
, len
);
588 id
= sftp_pkt_getuint32(pktin
);
589 fxp_got_status(pktin
);
590 return fxp_errtype
== SSH_FX_OK
;
594 * Free up an fxp_names structure.
596 void fxp_free_names(struct fxp_names
*names
) {
599 for (i
= 0; i
< names
->nnames
; i
++) {
600 sfree(names
->names
[i
].filename
);
601 sfree(names
->names
[i
].longname
);