Mercurial > repos > rliterman > csp2

annotate CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/include/libssh2_sftp.h @ 69:33d812a61356

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 17:55:14 -0400
parents
children
rev   line source
jpayne@69 1 /* Copyright (c) 2004-2008, Sara Golemon <sarag@libssh2.org>
jpayne@69 2 * All rights reserved.
jpayne@69 3 *
jpayne@69 4 * Redistribution and use in source and binary forms,
jpayne@69 5 * with or without modification, are permitted provided
jpayne@69 6 * that the following conditions are met:
jpayne@69 7 *
jpayne@69 8 * Redistributions of source code must retain the above
jpayne@69 9 * copyright notice, this list of conditions and the
jpayne@69 10 * following disclaimer.
jpayne@69 11 *
jpayne@69 12 * Redistributions in binary form must reproduce the above
jpayne@69 13 * copyright notice, this list of conditions and the following
jpayne@69 14 * disclaimer in the documentation and/or other materials
jpayne@69 15 * provided with the distribution.
jpayne@69 16 *
jpayne@69 17 * Neither the name of the copyright holder nor the names
jpayne@69 18 * of any other contributors may be used to endorse or
jpayne@69 19 * promote products derived from this software without
jpayne@69 20 * specific prior written permission.
jpayne@69 21 *
jpayne@69 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
jpayne@69 23 * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
jpayne@69 24 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
jpayne@69 25 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
jpayne@69 26 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
jpayne@69 27 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
jpayne@69 28 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
jpayne@69 29 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
jpayne@69 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
jpayne@69 31 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
jpayne@69 32 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
jpayne@69 33 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
jpayne@69 34 * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
jpayne@69 35 * OF SUCH DAMAGE.
jpayne@69 36 */
jpayne@69 37
jpayne@69 38 #ifndef LIBSSH2_SFTP_H
jpayne@69 39 #define LIBSSH2_SFTP_H 1
jpayne@69 40
jpayne@69 41 #include "libssh2.h"
jpayne@69 42
jpayne@69 43 #ifndef WIN32
jpayne@69 44 #include <unistd.h>
jpayne@69 45 #endif
jpayne@69 46
jpayne@69 47 #ifdef __cplusplus
jpayne@69 48 extern "C" {
jpayne@69 49 #endif
jpayne@69 50
jpayne@69 51 /* Note: Version 6 was documented at the time of writing
jpayne@69 52 * However it was marked as "DO NOT IMPLEMENT" due to pending changes
jpayne@69 53 *
jpayne@69 54 * Let's start with Version 3 (The version found in OpenSSH) and go from there
jpayne@69 55 */
jpayne@69 56 #define LIBSSH2_SFTP_VERSION 3
jpayne@69 57
jpayne@69 58 typedef struct _LIBSSH2_SFTP LIBSSH2_SFTP;
jpayne@69 59 typedef struct _LIBSSH2_SFTP_HANDLE LIBSSH2_SFTP_HANDLE;
jpayne@69 60 typedef struct _LIBSSH2_SFTP_ATTRIBUTES LIBSSH2_SFTP_ATTRIBUTES;
jpayne@69 61 typedef struct _LIBSSH2_SFTP_STATVFS LIBSSH2_SFTP_STATVFS;
jpayne@69 62
jpayne@69 63 /* Flags for open_ex() */
jpayne@69 64 #define LIBSSH2_SFTP_OPENFILE 0
jpayne@69 65 #define LIBSSH2_SFTP_OPENDIR 1
jpayne@69 66
jpayne@69 67 /* Flags for rename_ex() */
jpayne@69 68 #define LIBSSH2_SFTP_RENAME_OVERWRITE 0x00000001
jpayne@69 69 #define LIBSSH2_SFTP_RENAME_ATOMIC 0x00000002
jpayne@69 70 #define LIBSSH2_SFTP_RENAME_NATIVE 0x00000004
jpayne@69 71
jpayne@69 72 /* Flags for stat_ex() */
jpayne@69 73 #define LIBSSH2_SFTP_STAT 0
jpayne@69 74 #define LIBSSH2_SFTP_LSTAT 1
jpayne@69 75 #define LIBSSH2_SFTP_SETSTAT 2
jpayne@69 76
jpayne@69 77 /* Flags for symlink_ex() */
jpayne@69 78 #define LIBSSH2_SFTP_SYMLINK 0
jpayne@69 79 #define LIBSSH2_SFTP_READLINK 1
jpayne@69 80 #define LIBSSH2_SFTP_REALPATH 2
jpayne@69 81
jpayne@69 82 /* Flags for sftp_mkdir() */
jpayne@69 83 #define LIBSSH2_SFTP_DEFAULT_MODE -1
jpayne@69 84
jpayne@69 85 /* SFTP attribute flag bits */
jpayne@69 86 #define LIBSSH2_SFTP_ATTR_SIZE 0x00000001
jpayne@69 87 #define LIBSSH2_SFTP_ATTR_UIDGID 0x00000002
jpayne@69 88 #define LIBSSH2_SFTP_ATTR_PERMISSIONS 0x00000004
jpayne@69 89 #define LIBSSH2_SFTP_ATTR_ACMODTIME 0x00000008
jpayne@69 90 #define LIBSSH2_SFTP_ATTR_EXTENDED 0x80000000
jpayne@69 91
jpayne@69 92 /* SFTP statvfs flag bits */
jpayne@69 93 #define LIBSSH2_SFTP_ST_RDONLY 0x00000001
jpayne@69 94 #define LIBSSH2_SFTP_ST_NOSUID 0x00000002
jpayne@69 95
jpayne@69 96 struct _LIBSSH2_SFTP_ATTRIBUTES {
jpayne@69 97 /* If flags & ATTR_* bit is set, then the value in this struct will be
jpayne@69 98 * meaningful Otherwise it should be ignored
jpayne@69 99 */
jpayne@69 100 unsigned long flags;
jpayne@69 101
jpayne@69 102 libssh2_uint64_t filesize;
jpayne@69 103 unsigned long uid, gid;
jpayne@69 104 unsigned long permissions;
jpayne@69 105 unsigned long atime, mtime;
jpayne@69 106 };
jpayne@69 107
jpayne@69 108 struct _LIBSSH2_SFTP_STATVFS {
jpayne@69 109 libssh2_uint64_t f_bsize; /* file system block size */
jpayne@69 110 libssh2_uint64_t f_frsize; /* fragment size */
jpayne@69 111 libssh2_uint64_t f_blocks; /* size of fs in f_frsize units */
jpayne@69 112 libssh2_uint64_t f_bfree; /* # free blocks */
jpayne@69 113 libssh2_uint64_t f_bavail; /* # free blocks for non-root */
jpayne@69 114 libssh2_uint64_t f_files; /* # inodes */
jpayne@69 115 libssh2_uint64_t f_ffree; /* # free inodes */
jpayne@69 116 libssh2_uint64_t f_favail; /* # free inodes for non-root */
jpayne@69 117 libssh2_uint64_t f_fsid; /* file system ID */
jpayne@69 118 libssh2_uint64_t f_flag; /* mount flags */
jpayne@69 119 libssh2_uint64_t f_namemax; /* maximum filename length */
jpayne@69 120 };
jpayne@69 121
jpayne@69 122 /* SFTP filetypes */
jpayne@69 123 #define LIBSSH2_SFTP_TYPE_REGULAR 1
jpayne@69 124 #define LIBSSH2_SFTP_TYPE_DIRECTORY 2
jpayne@69 125 #define LIBSSH2_SFTP_TYPE_SYMLINK 3
jpayne@69 126 #define LIBSSH2_SFTP_TYPE_SPECIAL 4
jpayne@69 127 #define LIBSSH2_SFTP_TYPE_UNKNOWN 5
jpayne@69 128 #define LIBSSH2_SFTP_TYPE_SOCKET 6
jpayne@69 129 #define LIBSSH2_SFTP_TYPE_CHAR_DEVICE 7
jpayne@69 130 #define LIBSSH2_SFTP_TYPE_BLOCK_DEVICE 8
jpayne@69 131 #define LIBSSH2_SFTP_TYPE_FIFO 9
jpayne@69 132
jpayne@69 133 /*
jpayne@69 134 * Reproduce the POSIX file modes here for systems that are not POSIX
jpayne@69 135 * compliant.
jpayne@69 136 *
jpayne@69 137 * These is used in "permissions" of "struct _LIBSSH2_SFTP_ATTRIBUTES"
jpayne@69 138 */
jpayne@69 139 /* File type */
jpayne@69 140 #define LIBSSH2_SFTP_S_IFMT 0170000 /* type of file mask */
jpayne@69 141 #define LIBSSH2_SFTP_S_IFIFO 0010000 /* named pipe (fifo) */
jpayne@69 142 #define LIBSSH2_SFTP_S_IFCHR 0020000 /* character special */
jpayne@69 143 #define LIBSSH2_SFTP_S_IFDIR 0040000 /* directory */
jpayne@69 144 #define LIBSSH2_SFTP_S_IFBLK 0060000 /* block special */
jpayne@69 145 #define LIBSSH2_SFTP_S_IFREG 0100000 /* regular */
jpayne@69 146 #define LIBSSH2_SFTP_S_IFLNK 0120000 /* symbolic link */
jpayne@69 147 #define LIBSSH2_SFTP_S_IFSOCK 0140000 /* socket */
jpayne@69 148
jpayne@69 149 /* File mode */
jpayne@69 150 /* Read, write, execute/search by owner */
jpayne@69 151 #define LIBSSH2_SFTP_S_IRWXU 0000700 /* RWX mask for owner */
jpayne@69 152 #define LIBSSH2_SFTP_S_IRUSR 0000400 /* R for owner */
jpayne@69 153 #define LIBSSH2_SFTP_S_IWUSR 0000200 /* W for owner */
jpayne@69 154 #define LIBSSH2_SFTP_S_IXUSR 0000100 /* X for owner */
jpayne@69 155 /* Read, write, execute/search by group */
jpayne@69 156 #define LIBSSH2_SFTP_S_IRWXG 0000070 /* RWX mask for group */
jpayne@69 157 #define LIBSSH2_SFTP_S_IRGRP 0000040 /* R for group */
jpayne@69 158 #define LIBSSH2_SFTP_S_IWGRP 0000020 /* W for group */
jpayne@69 159 #define LIBSSH2_SFTP_S_IXGRP 0000010 /* X for group */
jpayne@69 160 /* Read, write, execute/search by others */
jpayne@69 161 #define LIBSSH2_SFTP_S_IRWXO 0000007 /* RWX mask for other */
jpayne@69 162 #define LIBSSH2_SFTP_S_IROTH 0000004 /* R for other */
jpayne@69 163 #define LIBSSH2_SFTP_S_IWOTH 0000002 /* W for other */
jpayne@69 164 #define LIBSSH2_SFTP_S_IXOTH 0000001 /* X for other */
jpayne@69 165
jpayne@69 166 /* macros to check for specific file types, added in 1.2.5 */
jpayne@69 167 #define LIBSSH2_SFTP_S_ISLNK(m) \
jpayne@69 168 (((m) & LIBSSH2_SFTP_S_IFMT) == LIBSSH2_SFTP_S_IFLNK)
jpayne@69 169 #define LIBSSH2_SFTP_S_ISREG(m) \
jpayne@69 170 (((m) & LIBSSH2_SFTP_S_IFMT) == LIBSSH2_SFTP_S_IFREG)
jpayne@69 171 #define LIBSSH2_SFTP_S_ISDIR(m) \
jpayne@69 172 (((m) & LIBSSH2_SFTP_S_IFMT) == LIBSSH2_SFTP_S_IFDIR)
jpayne@69 173 #define LIBSSH2_SFTP_S_ISCHR(m) \
jpayne@69 174 (((m) & LIBSSH2_SFTP_S_IFMT) == LIBSSH2_SFTP_S_IFCHR)
jpayne@69 175 #define LIBSSH2_SFTP_S_ISBLK(m) \
jpayne@69 176 (((m) & LIBSSH2_SFTP_S_IFMT) == LIBSSH2_SFTP_S_IFBLK)
jpayne@69 177 #define LIBSSH2_SFTP_S_ISFIFO(m) \
jpayne@69 178 (((m) & LIBSSH2_SFTP_S_IFMT) == LIBSSH2_SFTP_S_IFIFO)
jpayne@69 179 #define LIBSSH2_SFTP_S_ISSOCK(m) \
jpayne@69 180 (((m) & LIBSSH2_SFTP_S_IFMT) == LIBSSH2_SFTP_S_IFSOCK)
jpayne@69 181
jpayne@69 182 /* SFTP File Transfer Flags -- (e.g. flags parameter to sftp_open())
jpayne@69 183 * Danger will robinson... APPEND doesn't have any effect on OpenSSH servers */
jpayne@69 184 #define LIBSSH2_FXF_READ 0x00000001
jpayne@69 185 #define LIBSSH2_FXF_WRITE 0x00000002
jpayne@69 186 #define LIBSSH2_FXF_APPEND 0x00000004
jpayne@69 187 #define LIBSSH2_FXF_CREAT 0x00000008
jpayne@69 188 #define LIBSSH2_FXF_TRUNC 0x00000010
jpayne@69 189 #define LIBSSH2_FXF_EXCL 0x00000020
jpayne@69 190
jpayne@69 191 /* SFTP Status Codes (returned by libssh2_sftp_last_error() ) */
jpayne@69 192 #define LIBSSH2_FX_OK 0UL
jpayne@69 193 #define LIBSSH2_FX_EOF 1UL
jpayne@69 194 #define LIBSSH2_FX_NO_SUCH_FILE 2UL
jpayne@69 195 #define LIBSSH2_FX_PERMISSION_DENIED 3UL
jpayne@69 196 #define LIBSSH2_FX_FAILURE 4UL
jpayne@69 197 #define LIBSSH2_FX_BAD_MESSAGE 5UL
jpayne@69 198 #define LIBSSH2_FX_NO_CONNECTION 6UL
jpayne@69 199 #define LIBSSH2_FX_CONNECTION_LOST 7UL
jpayne@69 200 #define LIBSSH2_FX_OP_UNSUPPORTED 8UL
jpayne@69 201 #define LIBSSH2_FX_INVALID_HANDLE 9UL
jpayne@69 202 #define LIBSSH2_FX_NO_SUCH_PATH 10UL
jpayne@69 203 #define LIBSSH2_FX_FILE_ALREADY_EXISTS 11UL
jpayne@69 204 #define LIBSSH2_FX_WRITE_PROTECT 12UL
jpayne@69 205 #define LIBSSH2_FX_NO_MEDIA 13UL
jpayne@69 206 #define LIBSSH2_FX_NO_SPACE_ON_FILESYSTEM 14UL
jpayne@69 207 #define LIBSSH2_FX_QUOTA_EXCEEDED 15UL
jpayne@69 208 #define LIBSSH2_FX_UNKNOWN_PRINCIPLE 16UL /* Initial mis-spelling */
jpayne@69 209 #define LIBSSH2_FX_UNKNOWN_PRINCIPAL 16UL
jpayne@69 210 #define LIBSSH2_FX_LOCK_CONFlICT 17UL /* Initial mis-spelling */
jpayne@69 211 #define LIBSSH2_FX_LOCK_CONFLICT 17UL
jpayne@69 212 #define LIBSSH2_FX_DIR_NOT_EMPTY 18UL
jpayne@69 213 #define LIBSSH2_FX_NOT_A_DIRECTORY 19UL
jpayne@69 214 #define LIBSSH2_FX_INVALID_FILENAME 20UL
jpayne@69 215 #define LIBSSH2_FX_LINK_LOOP 21UL
jpayne@69 216
jpayne@69 217 /* Returned by any function that would block during a read/write operation */
jpayne@69 218 #define LIBSSH2SFTP_EAGAIN LIBSSH2_ERROR_EAGAIN
jpayne@69 219
jpayne@69 220 /* SFTP API */
jpayne@69 221 LIBSSH2_API LIBSSH2_SFTP *libssh2_sftp_init(LIBSSH2_SESSION *session);
jpayne@69 222 LIBSSH2_API int libssh2_sftp_shutdown(LIBSSH2_SFTP *sftp);
jpayne@69 223 LIBSSH2_API unsigned long libssh2_sftp_last_error(LIBSSH2_SFTP *sftp);
jpayne@69 224 LIBSSH2_API LIBSSH2_CHANNEL *libssh2_sftp_get_channel(LIBSSH2_SFTP *sftp);
jpayne@69 225
jpayne@69 226 /* File / Directory Ops */
jpayne@69 227 LIBSSH2_API LIBSSH2_SFTP_HANDLE *
jpayne@69 228 libssh2_sftp_open_ex(LIBSSH2_SFTP *sftp,
jpayne@69 229 const char *filename,
jpayne@69 230 unsigned int filename_len,
jpayne@69 231 unsigned long flags,
jpayne@69 232 long mode, int open_type);
jpayne@69 233 #define libssh2_sftp_open(sftp, filename, flags, mode) \
jpayne@69 234 libssh2_sftp_open_ex((sftp), (filename), strlen(filename), (flags), \
jpayne@69 235 (mode), LIBSSH2_SFTP_OPENFILE)
jpayne@69 236 #define libssh2_sftp_opendir(sftp, path) \
jpayne@69 237 libssh2_sftp_open_ex((sftp), (path), strlen(path), 0, 0, \
jpayne@69 238 LIBSSH2_SFTP_OPENDIR)
jpayne@69 239
jpayne@69 240 LIBSSH2_API ssize_t libssh2_sftp_read(LIBSSH2_SFTP_HANDLE *handle,
jpayne@69 241 char *buffer, size_t buffer_maxlen);
jpayne@69 242
jpayne@69 243 LIBSSH2_API int libssh2_sftp_readdir_ex(LIBSSH2_SFTP_HANDLE *handle, \
jpayne@69 244 char *buffer, size_t buffer_maxlen,
jpayne@69 245 char *longentry,
jpayne@69 246 size_t longentry_maxlen,
jpayne@69 247 LIBSSH2_SFTP_ATTRIBUTES *attrs);
jpayne@69 248 #define libssh2_sftp_readdir(handle, buffer, buffer_maxlen, attrs) \
jpayne@69 249 libssh2_sftp_readdir_ex((handle), (buffer), (buffer_maxlen), NULL, 0, \
jpayne@69 250 (attrs))
jpayne@69 251
jpayne@69 252 LIBSSH2_API ssize_t libssh2_sftp_write(LIBSSH2_SFTP_HANDLE *handle,
jpayne@69 253 const char *buffer, size_t count);
jpayne@69 254 LIBSSH2_API int libssh2_sftp_fsync(LIBSSH2_SFTP_HANDLE *handle);
jpayne@69 255
jpayne@69 256 LIBSSH2_API int libssh2_sftp_close_handle(LIBSSH2_SFTP_HANDLE *handle);
jpayne@69 257 #define libssh2_sftp_close(handle) libssh2_sftp_close_handle(handle)
jpayne@69 258 #define libssh2_sftp_closedir(handle) libssh2_sftp_close_handle(handle)
jpayne@69 259
jpayne@69 260 LIBSSH2_API void libssh2_sftp_seek(LIBSSH2_SFTP_HANDLE *handle, size_t offset);
jpayne@69 261 LIBSSH2_API void libssh2_sftp_seek64(LIBSSH2_SFTP_HANDLE *handle,
jpayne@69 262 libssh2_uint64_t offset);
jpayne@69 263 #define libssh2_sftp_rewind(handle) libssh2_sftp_seek64((handle), 0)
jpayne@69 264
jpayne@69 265 LIBSSH2_API size_t libssh2_sftp_tell(LIBSSH2_SFTP_HANDLE *handle);
jpayne@69 266 LIBSSH2_API libssh2_uint64_t libssh2_sftp_tell64(LIBSSH2_SFTP_HANDLE *handle);
jpayne@69 267
jpayne@69 268 LIBSSH2_API int libssh2_sftp_fstat_ex(LIBSSH2_SFTP_HANDLE *handle,
jpayne@69 269 LIBSSH2_SFTP_ATTRIBUTES *attrs,
jpayne@69 270 int setstat);
jpayne@69 271 #define libssh2_sftp_fstat(handle, attrs) \
jpayne@69 272 libssh2_sftp_fstat_ex((handle), (attrs), 0)
jpayne@69 273 #define libssh2_sftp_fsetstat(handle, attrs) \
jpayne@69 274 libssh2_sftp_fstat_ex((handle), (attrs), 1)
jpayne@69 275
jpayne@69 276 /* Miscellaneous Ops */
jpayne@69 277 LIBSSH2_API int libssh2_sftp_rename_ex(LIBSSH2_SFTP *sftp,
jpayne@69 278 const char *source_filename,
jpayne@69 279 unsigned int srouce_filename_len,
jpayne@69 280 const char *dest_filename,
jpayne@69 281 unsigned int dest_filename_len,
jpayne@69 282 long flags);
jpayne@69 283 #define libssh2_sftp_rename(sftp, sourcefile, destfile) \
jpayne@69 284 libssh2_sftp_rename_ex((sftp), (sourcefile), strlen(sourcefile), \
jpayne@69 285 (destfile), strlen(destfile), \
jpayne@69 286 LIBSSH2_SFTP_RENAME_OVERWRITE | \
jpayne@69 287 LIBSSH2_SFTP_RENAME_ATOMIC | \
jpayne@69 288 LIBSSH2_SFTP_RENAME_NATIVE)
jpayne@69 289
jpayne@69 290 LIBSSH2_API int libssh2_sftp_unlink_ex(LIBSSH2_SFTP *sftp,
jpayne@69 291 const char *filename,
jpayne@69 292 unsigned int filename_len);
jpayne@69 293 #define libssh2_sftp_unlink(sftp, filename) \
jpayne@69 294 libssh2_sftp_unlink_ex((sftp), (filename), strlen(filename))
jpayne@69 295
jpayne@69 296 LIBSSH2_API int libssh2_sftp_fstatvfs(LIBSSH2_SFTP_HANDLE *handle,
jpayne@69 297 LIBSSH2_SFTP_STATVFS *st);
jpayne@69 298
jpayne@69 299 LIBSSH2_API int libssh2_sftp_statvfs(LIBSSH2_SFTP *sftp,
jpayne@69 300 const char *path,
jpayne@69 301 size_t path_len,
jpayne@69 302 LIBSSH2_SFTP_STATVFS *st);
jpayne@69 303
jpayne@69 304 LIBSSH2_API int libssh2_sftp_mkdir_ex(LIBSSH2_SFTP *sftp,
jpayne@69 305 const char *path,
jpayne@69 306 unsigned int path_len, long mode);
jpayne@69 307 #define libssh2_sftp_mkdir(sftp, path, mode) \
jpayne@69 308 libssh2_sftp_mkdir_ex((sftp), (path), strlen(path), (mode))
jpayne@69 309
jpayne@69 310 LIBSSH2_API int libssh2_sftp_rmdir_ex(LIBSSH2_SFTP *sftp,
jpayne@69 311 const char *path,
jpayne@69 312 unsigned int path_len);
jpayne@69 313 #define libssh2_sftp_rmdir(sftp, path) \
jpayne@69 314 libssh2_sftp_rmdir_ex((sftp), (path), strlen(path))
jpayne@69 315
jpayne@69 316 LIBSSH2_API int libssh2_sftp_stat_ex(LIBSSH2_SFTP *sftp,
jpayne@69 317 const char *path,
jpayne@69 318 unsigned int path_len,
jpayne@69 319 int stat_type,
jpayne@69 320 LIBSSH2_SFTP_ATTRIBUTES *attrs);
jpayne@69 321 #define libssh2_sftp_stat(sftp, path, attrs) \
jpayne@69 322 libssh2_sftp_stat_ex((sftp), (path), strlen(path), LIBSSH2_SFTP_STAT, \
jpayne@69 323 (attrs))
jpayne@69 324 #define libssh2_sftp_lstat(sftp, path, attrs) \
jpayne@69 325 libssh2_sftp_stat_ex((sftp), (path), strlen(path), LIBSSH2_SFTP_LSTAT, \
jpayne@69 326 (attrs))
jpayne@69 327 #define libssh2_sftp_setstat(sftp, path, attrs) \
jpayne@69 328 libssh2_sftp_stat_ex((sftp), (path), strlen(path), LIBSSH2_SFTP_SETSTAT, \
jpayne@69 329 (attrs))
jpayne@69 330
jpayne@69 331 LIBSSH2_API int libssh2_sftp_symlink_ex(LIBSSH2_SFTP *sftp,
jpayne@69 332 const char *path,
jpayne@69 333 unsigned int path_len,
jpayne@69 334 char *target,
jpayne@69 335 unsigned int target_len,
jpayne@69 336 int link_type);
jpayne@69 337 #define libssh2_sftp_symlink(sftp, orig, linkpath) \
jpayne@69 338 libssh2_sftp_symlink_ex((sftp), (orig), strlen(orig), (linkpath), \
jpayne@69 339 strlen(linkpath), LIBSSH2_SFTP_SYMLINK)
jpayne@69 340 #define libssh2_sftp_readlink(sftp, path, target, maxlen) \
jpayne@69 341 libssh2_sftp_symlink_ex((sftp), (path), strlen(path), (target), (maxlen), \
jpayne@69 342 LIBSSH2_SFTP_READLINK)
jpayne@69 343 #define libssh2_sftp_realpath(sftp, path, target, maxlen) \
jpayne@69 344 libssh2_sftp_symlink_ex((sftp), (path), strlen(path), (target), (maxlen), \
jpayne@69 345 LIBSSH2_SFTP_REALPATH)
jpayne@69 346
jpayne@69 347 #ifdef __cplusplus
jpayne@69 348 } /* extern "C" */
jpayne@69 349 #endif
jpayne@69 350
jpayne@69 351 #endif /* LIBSSH2_SFTP_H */