libssh  0.8.2
The SSH library
sftp.h
1 /*
2  * This file is part of the SSH Library
3  *
4  * Copyright (c) 2003-2008 by Aris Adamantiadis
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with this library; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 
37 #ifndef SFTP_H
38 #define SFTP_H
39 
40 #include <sys/types.h>
41 
42 #include "libssh.h"
43 
44 #ifdef __cplusplus
45 extern "C" {
46 #endif
47 
48 #ifdef _WIN32
49 #ifndef uid_t
50  typedef uint32_t uid_t;
51 #endif /* uid_t */
52 #ifndef gid_t
53  typedef uint32_t gid_t;
54 #endif /* gid_t */
55 #ifdef _MSC_VER
56 #ifndef ssize_t
57  typedef _W64 SSIZE_T ssize_t;
58 #endif /* ssize_t */
59 #endif /* _MSC_VER */
60 #endif /* _WIN32 */
61 
62 #define LIBSFTP_VERSION 3
63 
66 typedef struct sftp_dir_struct* sftp_dir;
67 typedef struct sftp_ext_struct *sftp_ext;
68 typedef struct sftp_file_struct* sftp_file;
69 typedef struct sftp_message_struct* sftp_message;
70 typedef struct sftp_packet_struct* sftp_packet;
72 typedef struct sftp_session_struct* sftp_session;
74 typedef struct sftp_statvfs_struct* sftp_statvfs_t;
75 
77  ssh_session session;
78  ssh_channel channel;
79  int server_version;
80  int client_version;
81  int version;
82  sftp_request_queue queue;
83  uint32_t id_counter;
84  int errnum;
85  void **handles;
86  sftp_ext ext;
87 };
88 
90  sftp_session sftp;
91  uint8_t type;
92  ssh_buffer payload;
93 };
94 
95 /* file handler */
97  sftp_session sftp;
98  char *name;
99  uint64_t offset;
100  ssh_string handle;
101  int eof;
102  int nonblocking;
103 };
104 
106  sftp_session sftp;
107  char *name;
108  ssh_string handle; /* handle to directory */
109  ssh_buffer buffer; /* contains raw attributes from server which haven't been parsed */
110  uint32_t count; /* counts the number of following attributes structures into buffer */
111  int eof; /* end of directory listing */
112 };
113 
115  sftp_session sftp;
116  uint8_t packet_type;
117  ssh_buffer payload;
118  uint32_t id;
119 };
120 
121 /* this is a bunch of all data that could be into a message */
123  sftp_session sftp;
124  uint8_t type;
125  uint32_t id;
126  char *filename; /* can be "path" */
127  uint32_t flags;
128  sftp_attributes attr;
129  ssh_string handle;
130  uint64_t offset;
131  uint32_t len;
132  int attr_num;
133  ssh_buffer attrbuf; /* used by sftp_reply_attrs */
134  ssh_string data; /* can be newpath of rename() */
135  ssh_buffer complete_message; /* complete message in case of retransmission*/
136  char *str_data; /* cstring version of data */
137 };
138 
140  sftp_request_queue next;
141  sftp_message message;
142 };
143 
144 /* SSH_FXP_MESSAGE described into .7 page 26 */
146  uint32_t id;
147  uint32_t status;
148  ssh_string error_unused; /* not used anymore */
149  ssh_string lang_unused; /* not used anymore */
150  char *errormsg;
151  char *langmsg;
152 };
153 
155  char *name;
156  char *longname; /* ls -l output on openssh, not reliable else */
157  uint32_t flags;
158  uint8_t type;
159  uint64_t size;
160  uint32_t uid;
161  uint32_t gid;
162  char *owner; /* set if openssh and version 4 */
163  char *group; /* set if openssh and version 4 */
164  uint32_t permissions;
165  uint64_t atime64;
166  uint32_t atime;
167  uint32_t atime_nseconds;
168  uint64_t createtime;
169  uint32_t createtime_nseconds;
170  uint64_t mtime64;
171  uint32_t mtime;
172  uint32_t mtime_nseconds;
173  ssh_string acl;
174  uint32_t extended_count;
175  ssh_string extended_type;
176  ssh_string extended_data;
177 };
178 
183  uint64_t f_bsize;
184  uint64_t f_frsize;
185  uint64_t f_blocks;
186  uint64_t f_bfree;
187  uint64_t f_bavail;
188  uint64_t f_files;
189  uint64_t f_ffree;
190  uint64_t f_favail;
191  uint64_t f_fsid;
192  uint64_t f_flag;
193  uint64_t f_namemax;
194 };
195 
205 LIBSSH_API sftp_session sftp_new(ssh_session session);
206 
217 LIBSSH_API sftp_session sftp_new_channel(ssh_session session, ssh_channel channel);
218 
219 
225 LIBSSH_API void sftp_free(sftp_session sftp);
226 
236 LIBSSH_API int sftp_init(sftp_session sftp);
237 
250 LIBSSH_API int sftp_get_error(sftp_session sftp);
251 
260 LIBSSH_API unsigned int sftp_extensions_get_count(sftp_session sftp);
261 
271 LIBSSH_API const char *sftp_extensions_get_name(sftp_session sftp, unsigned int indexn);
272 
284 LIBSSH_API const char *sftp_extensions_get_data(sftp_session sftp, unsigned int indexn);
285 
303 LIBSSH_API int sftp_extension_supported(sftp_session sftp, const char *name,
304  const char *data);
305 
318 LIBSSH_API sftp_dir sftp_opendir(sftp_session session, const char *path);
319 
333 LIBSSH_API sftp_attributes sftp_readdir(sftp_session session, sftp_dir dir);
334 
344 LIBSSH_API int sftp_dir_eof(sftp_dir dir);
345 
358 LIBSSH_API sftp_attributes sftp_stat(sftp_session session, const char *path);
359 
375 LIBSSH_API sftp_attributes sftp_lstat(sftp_session session, const char *path);
376 
387 LIBSSH_API sftp_attributes sftp_fstat(sftp_file file);
388 
394 LIBSSH_API void sftp_attributes_free(sftp_attributes file);
395 
403 LIBSSH_API int sftp_closedir(sftp_dir dir);
404 
414 LIBSSH_API int sftp_close(sftp_file file);
415 
444 LIBSSH_API sftp_file sftp_open(sftp_session session, const char *file, int accesstype,
445  mode_t mode);
446 
452 LIBSSH_API void sftp_file_set_nonblocking(sftp_file handle);
453 
459 LIBSSH_API void sftp_file_set_blocking(sftp_file handle);
460 
475 LIBSSH_API ssize_t sftp_read(sftp_file file, void *buf, size_t count);
476 
508 LIBSSH_API int sftp_async_read_begin(sftp_file file, uint32_t len);
509 
533 LIBSSH_API int sftp_async_read(sftp_file file, void *data, uint32_t len, uint32_t id);
534 
551 LIBSSH_API ssize_t sftp_write(sftp_file file, const void *buf, size_t count);
552 
562 LIBSSH_API int sftp_seek(sftp_file file, uint32_t new_offset);
563 
574 LIBSSH_API int sftp_seek64(sftp_file file, uint64_t new_offset);
575 
585 LIBSSH_API unsigned long sftp_tell(sftp_file file);
586 
596 LIBSSH_API uint64_t sftp_tell64(sftp_file file);
597 
604 LIBSSH_API void sftp_rewind(sftp_file file);
605 
617 LIBSSH_API int sftp_unlink(sftp_session sftp, const char *file);
618 
630 LIBSSH_API int sftp_rmdir(sftp_session sftp, const char *directory);
631 
647 LIBSSH_API int sftp_mkdir(sftp_session sftp, const char *directory, mode_t mode);
648 
664 LIBSSH_API int sftp_rename(sftp_session sftp, const char *original, const char *newname);
665 
680 LIBSSH_API int sftp_setstat(sftp_session sftp, const char *file, sftp_attributes attr);
681 
697 LIBSSH_API int sftp_chown(sftp_session sftp, const char *file, uid_t owner, gid_t group);
698 
714 LIBSSH_API int sftp_chmod(sftp_session sftp, const char *file, mode_t mode);
715 
730 LIBSSH_API int sftp_utimes(sftp_session sftp, const char *file, const struct timeval *times);
731 
745 LIBSSH_API int sftp_symlink(sftp_session sftp, const char *target, const char *dest);
746 
758 LIBSSH_API char *sftp_readlink(sftp_session sftp, const char *path);
759 
771 LIBSSH_API sftp_statvfs_t sftp_statvfs(sftp_session sftp, const char *path);
772 
782 LIBSSH_API sftp_statvfs_t sftp_fstatvfs(sftp_file file);
783 
789 LIBSSH_API void sftp_statvfs_free(sftp_statvfs_t statvfs_o);
790 
805 LIBSSH_API int sftp_fsync(sftp_file file);
806 
816 LIBSSH_API char *sftp_canonicalize_path(sftp_session sftp, const char *path);
817 
825 LIBSSH_API int sftp_server_version(sftp_session sftp);
826 
827 #ifdef WITH_SERVER
828 
837 LIBSSH_API sftp_session sftp_server_new(ssh_session session, ssh_channel chan);
838 
846 LIBSSH_API int sftp_server_init(sftp_session sftp);
847 #endif /* WITH_SERVER */
848 
849 /* this is not a public interface */
850 #define SFTP_HANDLES 256
851 sftp_packet sftp_packet_read(sftp_session sftp);
852 int sftp_packet_write(sftp_session sftp,uint8_t type, ssh_buffer payload);
853 void sftp_packet_free(sftp_packet packet);
854 int buffer_add_attributes(ssh_buffer buffer, sftp_attributes attr);
855 sftp_attributes sftp_parse_attr(sftp_session session, ssh_buffer buf,int expectname);
856 /* sftpserver.c */
857 
858 LIBSSH_API sftp_client_message sftp_get_client_message(sftp_session sftp);
859 LIBSSH_API void sftp_client_message_free(sftp_client_message msg);
860 LIBSSH_API uint8_t sftp_client_message_get_type(sftp_client_message msg);
861 LIBSSH_API const char *sftp_client_message_get_filename(sftp_client_message msg);
862 LIBSSH_API void sftp_client_message_set_filename(sftp_client_message msg, const char *newname);
863 LIBSSH_API const char *sftp_client_message_get_data(sftp_client_message msg);
864 LIBSSH_API uint32_t sftp_client_message_get_flags(sftp_client_message msg);
865 LIBSSH_API int sftp_send_client_message(sftp_session sftp, sftp_client_message msg);
866 LIBSSH_API int sftp_reply_name(sftp_client_message msg, const char *name,
867  sftp_attributes attr);
868 LIBSSH_API int sftp_reply_handle(sftp_client_message msg, ssh_string handle);
869 LIBSSH_API ssh_string sftp_handle_alloc(sftp_session sftp, void *info);
870 LIBSSH_API int sftp_reply_attr(sftp_client_message msg, sftp_attributes attr);
871 LIBSSH_API void *sftp_handle(sftp_session sftp, ssh_string handle);
872 LIBSSH_API int sftp_reply_status(sftp_client_message msg, uint32_t status, const char *message);
873 LIBSSH_API int sftp_reply_names_add(sftp_client_message msg, const char *file,
874  const char *longname, sftp_attributes attr);
875 LIBSSH_API int sftp_reply_names(sftp_client_message msg);
876 LIBSSH_API int sftp_reply_data(sftp_client_message msg, const void *data, int len);
877 LIBSSH_API void sftp_handle_remove(sftp_session sftp, void *handle);
878 
879 /* SFTP commands and constants */
880 #define SSH_FXP_INIT 1
881 #define SSH_FXP_VERSION 2
882 #define SSH_FXP_OPEN 3
883 #define SSH_FXP_CLOSE 4
884 #define SSH_FXP_READ 5
885 #define SSH_FXP_WRITE 6
886 #define SSH_FXP_LSTAT 7
887 #define SSH_FXP_FSTAT 8
888 #define SSH_FXP_SETSTAT 9
889 #define SSH_FXP_FSETSTAT 10
890 #define SSH_FXP_OPENDIR 11
891 #define SSH_FXP_READDIR 12
892 #define SSH_FXP_REMOVE 13
893 #define SSH_FXP_MKDIR 14
894 #define SSH_FXP_RMDIR 15
895 #define SSH_FXP_REALPATH 16
896 #define SSH_FXP_STAT 17
897 #define SSH_FXP_RENAME 18
898 #define SSH_FXP_READLINK 19
899 #define SSH_FXP_SYMLINK 20
900 
901 #define SSH_FXP_STATUS 101
902 #define SSH_FXP_HANDLE 102
903 #define SSH_FXP_DATA 103
904 #define SSH_FXP_NAME 104
905 #define SSH_FXP_ATTRS 105
906 
907 #define SSH_FXP_EXTENDED 200
908 #define SSH_FXP_EXTENDED_REPLY 201
909 
910 /* attributes */
911 /* sftp draft is completely braindead : version 3 and 4 have different flags for same constants */
912 /* and even worst, version 4 has same flag for 2 different constants */
913 /* follow up : i won't develop any sftp4 compliant library before having a clarification */
914 
915 #define SSH_FILEXFER_ATTR_SIZE 0x00000001
916 #define SSH_FILEXFER_ATTR_PERMISSIONS 0x00000004
917 #define SSH_FILEXFER_ATTR_ACCESSTIME 0x00000008
918 #define SSH_FILEXFER_ATTR_ACMODTIME 0x00000008
919 #define SSH_FILEXFER_ATTR_CREATETIME 0x00000010
920 #define SSH_FILEXFER_ATTR_MODIFYTIME 0x00000020
921 #define SSH_FILEXFER_ATTR_ACL 0x00000040
922 #define SSH_FILEXFER_ATTR_OWNERGROUP 0x00000080
923 #define SSH_FILEXFER_ATTR_SUBSECOND_TIMES 0x00000100
924 #define SSH_FILEXFER_ATTR_EXTENDED 0x80000000
925 #define SSH_FILEXFER_ATTR_UIDGID 0x00000002
926 
927 /* types */
928 #define SSH_FILEXFER_TYPE_REGULAR 1
929 #define SSH_FILEXFER_TYPE_DIRECTORY 2
930 #define SSH_FILEXFER_TYPE_SYMLINK 3
931 #define SSH_FILEXFER_TYPE_SPECIAL 4
932 #define SSH_FILEXFER_TYPE_UNKNOWN 5
933 
942 #define SSH_FX_OK 0
943 
944 #define SSH_FX_EOF 1
945 
946 #define SSH_FX_NO_SUCH_FILE 2
947 
948 #define SSH_FX_PERMISSION_DENIED 3
949 
950 #define SSH_FX_FAILURE 4
951 
952 #define SSH_FX_BAD_MESSAGE 5
953 
954 #define SSH_FX_NO_CONNECTION 6
955 
956 #define SSH_FX_CONNECTION_LOST 7
957 
958 #define SSH_FX_OP_UNSUPPORTED 8
959 
960 #define SSH_FX_INVALID_HANDLE 9
961 
962 #define SSH_FX_NO_SUCH_PATH 10
963 
964 #define SSH_FX_FILE_ALREADY_EXISTS 11
965 
966 #define SSH_FX_WRITE_PROTECT 12
967 
968 #define SSH_FX_NO_MEDIA 13
969 
972 /* file flags */
973 #define SSH_FXF_READ 0x01
974 #define SSH_FXF_WRITE 0x02
975 #define SSH_FXF_APPEND 0x04
976 #define SSH_FXF_CREAT 0x08
977 #define SSH_FXF_TRUNC 0x10
978 #define SSH_FXF_EXCL 0x20
979 #define SSH_FXF_TEXT 0x40
980 
981 /* file type flags */
982 #define SSH_S_IFMT 00170000
983 #define SSH_S_IFSOCK 0140000
984 #define SSH_S_IFLNK 0120000
985 #define SSH_S_IFREG 0100000
986 #define SSH_S_IFBLK 0060000
987 #define SSH_S_IFDIR 0040000
988 #define SSH_S_IFCHR 0020000
989 #define SSH_S_IFIFO 0010000
990 
991 /* rename flags */
992 #define SSH_FXF_RENAME_OVERWRITE 0x00000001
993 #define SSH_FXF_RENAME_ATOMIC 0x00000002
994 #define SSH_FXF_RENAME_NATIVE 0x00000004
995 
996 #define SFTP_OPEN SSH_FXP_OPEN
997 #define SFTP_CLOSE SSH_FXP_CLOSE
998 #define SFTP_READ SSH_FXP_READ
999 #define SFTP_WRITE SSH_FXP_WRITE
1000 #define SFTP_LSTAT SSH_FXP_LSTAT
1001 #define SFTP_FSTAT SSH_FXP_FSTAT
1002 #define SFTP_SETSTAT SSH_FXP_SETSTAT
1003 #define SFTP_FSETSTAT SSH_FXP_FSETSTAT
1004 #define SFTP_OPENDIR SSH_FXP_OPENDIR
1005 #define SFTP_READDIR SSH_FXP_READDIR
1006 #define SFTP_REMOVE SSH_FXP_REMOVE
1007 #define SFTP_MKDIR SSH_FXP_MKDIR
1008 #define SFTP_RMDIR SSH_FXP_RMDIR
1009 #define SFTP_REALPATH SSH_FXP_REALPATH
1010 #define SFTP_STAT SSH_FXP_STAT
1011 #define SFTP_RENAME SSH_FXP_RENAME
1012 #define SFTP_READLINK SSH_FXP_READLINK
1013 #define SFTP_SYMLINK SSH_FXP_SYMLINK
1014 
1015 /* openssh flags */
1016 #define SSH_FXE_STATVFS_ST_RDONLY 0x1 /* read-only */
1017 #define SSH_FXE_STATVFS_ST_NOSUID 0x2 /* no setuid */
1018 
1019 #ifdef __cplusplus
1020 }
1021 #endif
1022 
1023 #endif /* SFTP_H */
1024 
Definition: sftp.h:114
LIBSSH_API int sftp_unlink(sftp_session sftp, const char *file)
Unlink (delete) a file.
LIBSSH_API int sftp_dir_eof(sftp_dir dir)
Tell if the directory has reached EOF (End Of File).
LIBSSH_API int sftp_fsync(sftp_file file)
Synchronize a file&#39;s in-core state with storage device.
LIBSSH_API char * sftp_canonicalize_path(sftp_session sftp, const char *path)
Canonicalize a sftp path.
uint64_t f_bfree
Definition: sftp.h:186
LIBSSH_API sftp_dir sftp_opendir(sftp_session session, const char *path)
Open a directory used to obtain directory entries.
LIBSSH_API int sftp_rename(sftp_session sftp, const char *original, const char *newname)
Rename or move a file or directory.
LIBSSH_API int sftp_extension_supported(sftp_session sftp, const char *name, const char *data)
Check if the given extension is supported.
LIBSSH_API int sftp_async_read_begin(sftp_file file, uint32_t len)
Start an asynchronous read from a file using an opened sftp file handle.
LIBSSH_API int sftp_utimes(sftp_session sftp, const char *file, const struct timeval *times)
Change the last modification and access time of a file.
Definition: channels.h:57
LIBSSH_API void sftp_statvfs_free(sftp_statvfs_t statvfs_o)
Free the memory of an allocated statvfs.
LIBSSH_API int sftp_rmdir(sftp_session sftp, const char *directory)
Remove a directoy.
Definition: sftp.h:139
uint64_t f_favail
Definition: sftp.h:190
Definition: sftp.h:105
Definition: session.h:96
LIBSSH_API void sftp_file_set_blocking(sftp_file handle)
Make the sftp communication for this file handle blocking.
LIBSSH_API int sftp_server_version(sftp_session sftp)
Get the version of the SFTP protocol supported by the server.
uint64_t f_files
Definition: sftp.h:188
LIBSSH_API int sftp_chown(sftp_session sftp, const char *file, uid_t owner, gid_t group)
Change the file owner and group.
uint64_t f_ffree
Definition: sftp.h:189
LIBSSH_API const char * sftp_extensions_get_data(sftp_session sftp, unsigned int indexn)
Get the data of the extension provided by the server.
SFTP statvfs structure.
Definition: sftp.h:182
LIBSSH_API sftp_session sftp_new(ssh_session session)
Start a new sftp session.
LIBSSH_API int sftp_setstat(sftp_session sftp, const char *file, sftp_attributes attr)
Set file attributes on a file, directory or symbolic link.
LIBSSH_API sftp_attributes sftp_fstat(sftp_file file)
Get information about a file or directory from a file handle.
LIBSSH_API const char * sftp_extensions_get_name(sftp_session sftp, unsigned int indexn)
Get the name of the extension provided by the server.
LIBSSH_API unsigned long sftp_tell(sftp_file file)
Report current byte position in file.
Definition: sftp.h:76
uint64_t f_fsid
Definition: sftp.h:191
Definition: sftp.h:122
LIBSSH_API char * sftp_readlink(sftp_session sftp, const char *path)
Read the value of a symbolic link.
Definition: sftp.h:145
uint64_t f_namemax
Definition: sftp.h:193
Definition: string.h:29
LIBSSH_API int sftp_seek(sftp_file file, uint32_t new_offset)
Seek to a specific location in a file.
LIBSSH_API int sftp_close(sftp_file file)
Close an open file handle.
LIBSSH_API sftp_session sftp_new_channel(ssh_session session, ssh_channel channel)
Start a new sftp session with an existing channel.
LIBSSH_API unsigned int sftp_extensions_get_count(sftp_session sftp)
Get the count of extensions provided by the server.
Definition: sftp.h:96
LIBSSH_API sftp_attributes sftp_readdir(sftp_session session, sftp_dir dir)
Get a single file attributes structure of a directory.
LIBSSH_API void sftp_rewind(sftp_file file)
Rewinds the position of the file pointer to the beginning of the file.
LIBSSH_API int sftp_get_error(sftp_session sftp)
Get the last sftp error.
LIBSSH_API int sftp_seek64(sftp_file file, uint64_t new_offset)
Seek to a specific location in a file. This is the 64bit version.
uint64_t f_bavail
Definition: sftp.h:187
LIBSSH_API int sftp_async_read(sftp_file file, void *data, uint32_t len, uint32_t id)
Wait for an asynchronous read to complete and save the data.
uint64_t f_frsize
Definition: sftp.h:184
LIBSSH_API int sftp_init(sftp_session sftp)
Initialize the sftp session with the server.
LIBSSH_API int sftp_closedir(sftp_dir dir)
Close a directory handle opened by sftp_opendir().
LIBSSH_API int sftp_symlink(sftp_session sftp, const char *target, const char *dest)
Create a symbolic link.
LIBSSH_API sftp_statvfs_t sftp_statvfs(sftp_session sftp, const char *path)
Get information about a mounted file system.
uint64_t f_blocks
Definition: sftp.h:185
LIBSSH_API void sftp_file_set_nonblocking(sftp_file handle)
Make the sftp communication for this file handle non blocking.
LIBSSH_API ssize_t sftp_write(sftp_file file, const void *buf, size_t count)
Write to a file using an opened sftp file handle.
Definition: sftp.h:154
LIBSSH_API void sftp_attributes_free(sftp_attributes file)
Free a sftp attribute structure.
LIBSSH_API ssize_t sftp_read(sftp_file file, void *buf, size_t count)
Read from a file using an opened sftp file handle.
LIBSSH_API sftp_statvfs_t sftp_fstatvfs(sftp_file file)
Get information about a mounted file system.
LIBSSH_API int sftp_chmod(sftp_session sftp, const char *file, mode_t mode)
Change permissions of a file.
LIBSSH_API sftp_file sftp_open(sftp_session session, const char *file, int accesstype, mode_t mode)
Open a file on the server.
uint64_t f_flag
Definition: sftp.h:192
LIBSSH_API uint64_t sftp_tell64(sftp_file file)
Report current byte position in file.
LIBSSH_API void sftp_free(sftp_session sftp)
Close and deallocate a sftp session.
Definition: sftp.h:89
LIBSSH_API sftp_attributes sftp_stat(sftp_session session, const char *path)
Get information about a file or directory.
LIBSSH_API int sftp_mkdir(sftp_session sftp, const char *directory, mode_t mode)
Create a directory.
Definition: buffer.h:34
LIBSSH_API sftp_attributes sftp_lstat(sftp_session session, const char *path)
Get information about a file or directory.