include/libssh2_sftp.h - third_party/libssh2 - Git at Google

 /* Copyright (c) 2004-2005, Sara Golemon <sarag@libssh2.org>
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms,
  * with or without modification, are permitted provided
  * that the following conditions are met:
  *
  *   Redistributions of source code must retain the above
  *   copyright notice, this list of conditions and the
  *   following disclaimer.
  *
  *   Redistributions in binary form must reproduce the above
  *   copyright notice, this list of conditions and the following
  *   disclaimer in the documentation and/or other materials
  *   provided with the distribution.
  *
  *   Neither the name of the copyright holder nor the names
  *   of any other contributors may be used to endorse or
  *   promote products derived from this software without
  *   specific prior written permission.
  *
  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
  * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
  * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
  * OF SUCH DAMAGE.
  */

 #ifndef LIBSSH2_SFTP_H
 #define LIBSSH2_SFTP_H 1

 /* Note: Version 6 was documented at the time of writing
  * However it was marked as "DO NOT IMPLEMENT" due to pending changes
  *
  * Let's start with Version 3 (The version found in OpenSSH) and go from there
  */
 #define LIBSSH2_SFTP_VERSION		3
 #define LIBSSH2_SFTP_PACKET_MAXLEN	40000

 typedef struct _LIBSSH2_SFTP				LIBSSH2_SFTP;
 typedef struct _LIBSSH2_SFTP_HANDLE			LIBSSH2_SFTP_HANDLE;
 typedef struct _LIBSSH2_SFTP_ATTRIBUTES		LIBSSH2_SFTP_ATTRIBUTES;

 /* Flags for open_ex() */
 #define LIBSSH2_SFTP_OPENFILE			0
 #define LIBSSH2_SFTP_OPENDIR			1

 /* Flags for rename_ex() */
 #define LIBSSH2_SFTP_RENAME_OVERWRITE	0x00000001
 #define LIBSSH2_SFTP_RENAME_ATOMIC		0x00000002
 #define LIBSSH2_SFTP_RENAME_NATIVE		0x00000004

 /* Flags for stat_ex() */
 #define LIBSSH2_SFTP_STAT				0
 #define LIBSSH2_SFTP_LSTAT				1
 #define LIBSSH2_SFTP_SETSTAT			2

 /* Flags for symlink_ex() */
 #define LIBSSH2_SFTP_SYMLINK			0
 #define LIBSSH2_SFTP_READLINK			1
 #define LIBSSH2_SFTP_REALPATH			2

 /* SFTP attribute flag bits */
 #define LIBSSH2_SFTP_ATTR_SIZE				0x00000001
 #define LIBSSH2_SFTP_ATTR_UIDGID			0x00000002
 #define LIBSSH2_SFTP_ATTR_PERMISSIONS		0x00000004
 #define LIBSSH2_SFTP_ATTR_ACMODTIME			0x00000008
 #define LIBSSH2_SFTP_ATTR_EXTENDED			0x80000000

 struct _LIBSSH2_SFTP_ATTRIBUTES {
 	/* If flags & ATTR_* bit is set, then the value in this struct will be meaningful
 	 * Otherwise it should be ignored
 	 */
 	unsigned long flags;

 	libssh2_uint64_t filesize;
 	unsigned long uid, gid;
 	unsigned long permissions;
 	unsigned long atime, mtime;
 };

 /* SFTP filetypes */
 #define LIBSSH2_SFTP_TYPE_REGULAR			1
 #define LIBSSH2_SFTP_TYPE_DIRECTORY			2
 #define LIBSSH2_SFTP_TYPE_SYMLINK			3
 #define LIBSSH2_SFTP_TYPE_SPECIAL			4
 #define LIBSSH2_SFTP_TYPE_UNKNOWN			5
 #define LIBSSH2_SFTP_TYPE_SOCKET			6
 #define LIBSSH2_SFTP_TYPE_CHAR_DEVICE		7
 #define LIBSSH2_SFTP_TYPE_BLOCK_DEVICE		8
 #define LIBSSH2_SFTP_TYPE_FIFO				9

 /* SFTP File Transfer Flags -- (e.g. flags parameter to sftp_open())
  * Danger will robinson... APPEND doesn't have any effect on OpenSSH servers */
 #define LIBSSH2_FXF_READ						0x00000001
 #define LIBSSH2_FXF_WRITE						0x00000002
 #define LIBSSH2_FXF_APPEND						0x00000004
 #define LIBSSH2_FXF_CREAT						0x00000008
 #define LIBSSH2_FXF_TRUNC						0x00000010
 #define LIBSSH2_FXF_EXCL						0x00000020

 /* SFTP Status Codes (returned by libssh2_sftp_last_error() ) */
 #define LIBSSH2_FX_OK						0
 #define LIBSSH2_FX_EOF						1
 #define LIBSSH2_FX_NO_SUCH_FILE				2
 #define LIBSSH2_FX_PERMISSION_DENIED		3
 #define LIBSSH2_FX_FAILURE					4
 #define LIBSSH2_FX_BAD_MESSAGE				5
 #define LIBSSH2_FX_NO_CONNECTION			6
 #define LIBSSH2_FX_CONNECTION_LOST			7
 #define LIBSSH2_FX_OP_UNSUPPORTED			8
 #define LIBSSH2_FX_INVALID_HANDLE			9
 #define LIBSSH2_FX_NO_SUCH_PATH				10
 #define LIBSSH2_FX_FILE_ALREADY_EXISTS		11
 #define LIBSSH2_FX_WRITE_PROTECT			12
 #define LIBSSH2_FX_NO_MEDIA					13
 #define LIBSSH2_FX_NO_SPACE_ON_FILESYSTEM	14
 #define LIBSSH2_FX_QUOTA_EXCEEDED			15
 #define LIBSSH2_FX_UNKNOWN_PRINCIPLE		16
 #define LIBSSH2_FX_LOCK_CONFlICT			17
 #define LIBSSH2_FX_DIR_NOT_EMPTY			18
 #define LIBSSH2_FX_NOT_A_DIRECTORY			19
 #define LIBSSH2_FX_INVALID_FILENAME			20
 #define LIBSSH2_FX_LINK_LOOP				21

 /* SFTP API */
 LIBSSH2_API LIBSSH2_SFTP *libssh2_sftp_init(LIBSSH2_SESSION *session);
 LIBSSH2_API int libssh2_sftp_shutdown(LIBSSH2_SFTP *sftp);
 LIBSSH2_API unsigned long libssh2_sftp_last_error(LIBSSH2_SFTP *sftp);

 /* File / Directory Ops */
 LIBSSH2_API LIBSSH2_SFTP_HANDLE *libssh2_sftp_open_ex(LIBSSH2_SFTP *sftp, char *filename, int filename_len, unsigned long flags, long mode, int open_type);
 #define libssh2_sftp_open(sftp, filename, flags, mode)			libssh2_sftp_open_ex((sftp), (filename), strlen(filename), (flags), (mode), LIBSSH2_SFTP_OPENFILE)
 #define libssh2_sftp_opendir(sftp, path)						libssh2_sftp_open_ex((sftp), (path), strlen(path), 0, 0, LIBSSH2_SFTP_OPENDIR)

 LIBSSH2_API size_t libssh2_sftp_read(LIBSSH2_SFTP_HANDLE *handle, char *buffer, size_t buffer_maxlen);
 LIBSSH2_API int libssh2_sftp_readdir(LIBSSH2_SFTP_HANDLE *handle, char *buffer, size_t buffer_maxlen, LIBSSH2_SFTP_ATTRIBUTES *attrs);
 LIBSSH2_API size_t libssh2_sftp_write(LIBSSH2_SFTP_HANDLE *handle, const char *buffer, size_t count);

 LIBSSH2_API int libssh2_sftp_close_handle(LIBSSH2_SFTP_HANDLE *handle);
 #define libssh2_sftp_close(handle)					libssh2_sftp_close_handle(handle)
 #define libssh2_sftp_closedir(handle)				libssh2_sftp_close_handle(handle)

 LIBSSH2_API void libssh2_sftp_seek(LIBSSH2_SFTP_HANDLE *handle, size_t offset);
 #define libssh2_sftp_rewind(handle)			libssh2_sftp_seek((handle), 0)

 LIBSSH2_API size_t libssh2_sftp_tell(LIBSSH2_SFTP_HANDLE *handle);

 LIBSSH2_API int libssh2_sftp_fstat_ex(LIBSSH2_SFTP_HANDLE *handle, LIBSSH2_SFTP_ATTRIBUTES *attrs, int setstat);
 #define libssh2_sftp_fstat(handle, attrs)				libssh2_sftp_fstat_ex((handle), (attrs), 0)
 #define libssh2_sftp_fsetstat(handle, attrs)			libssh2_sftp_fstat_ex((handle), (attrs), 1)


 /* Miscellaneous Ops */
 LIBSSH2_API int libssh2_sftp_rename_ex(LIBSSH2_SFTP *sftp,	char *source_filename,	int srouce_filename_len,
 															char *dest_filename,	int dest_filename_len,
 															long flags);
 #define libssh2_sftp_rename(sftp, sourcefile, destfile)		libssh2_sftp_rename_ex((sftp), (sourcefile), strlen(sourcefile), (destfile), strlen(destfile), \
 															LIBSSH2_SFTP_RENAME_OVERWRITE | LIBSSH2_SFTP_RENAME_ATOMIC | LIBSSH2_SFTP_RENAME_NATIVE)

 LIBSSH2_API int libssh2_sftp_unlink_ex(LIBSSH2_SFTP *sftp, char *filename, int filename_len);
 #define libssh2_sftp_unlink(sftp, filename)					libssh2_sftp_unlink_ex((sftp), (filename), strlen(filename))

 LIBSSH2_API int libssh2_sftp_mkdir_ex(LIBSSH2_SFTP *sftp, char *path, int path_len, long mode);
 #define libssh2_sftp_mkdir(sftp, path, mode)				libssh2_sftp_mkdir_ex((sftp), (path), strlen(path), (mode))

 LIBSSH2_API int libssh2_sftp_rmdir_ex(LIBSSH2_SFTP *sftp, char *path, int path_len);
 #define libssh2_sftp_rmdir(sftp, path)						libssh2_sftp_rmdir_ex((sftp), (path), strlen(path))

 LIBSSH2_API int libssh2_sftp_stat_ex(LIBSSH2_SFTP *sftp, char *path, int path_len, int stat_type, LIBSSH2_SFTP_ATTRIBUTES *attrs);
 #define libssh2_sftp_stat(sftp, path, attrs)				libssh2_sftp_stat_ex((sftp), (path), strlen(path), LIBSSH2_SFTP_STAT, (attrs))
 #define libssh2_sftp_lstat(sftp, path, attrs)				libssh2_sftp_stat_ex((sftp), (path), strlen(path), LIBSSH2_SFTP_LSTAT, (attrs))
 #define libssh2_sftp_setstat(sftp, path, attrs)				libssh2_sftp_stat_ex((sftp), (path), strlen(path), LIBSSH2_SFTP_SETSTAT, (attrs))

 LIBSSH2_API int libssh2_sftp_symlink_ex(LIBSSH2_SFTP *sftp, const char *path, int path_len, char *target, int target_len, int link_type);
 #define libssh2_sftp_symlink(sftp, orig, linkpath)			libssh2_sftp_symlink_ex((sftp), (orig), strlen(orig), (linkpath), strlen(linkpath), LIBSSH2_SFTP_SYMLINK)
 #define libssh2_sftp_readlink(sftp, path, target, maxlen)	libssh2_sftp_symlink_ex((sftp), (path), strlen(path), (target), (maxlen), LIBSSH2_SFTP_READLINK)
 #define libssh2_sftp_realpath(sftp, path, target, maxlen)	libssh2_sftp_symlink_ex((sftp), (path), strlen(path), (target), (maxlen), LIBSSH2_SFTP_REALPATH)

 #endif /* LIBSSH2_SFTP_H */
	/* Copyright (c) 2004-2005, Sara Golemon <sarag@libssh2.org>
	* All rights reserved.
	*
	* Redistribution and use in source and binary forms,
	* with or without modification, are permitted provided
	* that the following conditions are met:
	*
	* Redistributions of source code must retain the above
	* copyright notice, this list of conditions and the
	* following disclaimer.
	*
	* Redistributions in binary form must reproduce the above
	* copyright notice, this list of conditions and the following
	* disclaimer in the documentation and/or other materials
	* provided with the distribution.
	*
	* Neither the name of the copyright holder nor the names
	* of any other contributors may be used to endorse or
	* promote products derived from this software without
	* specific prior written permission.
	*
	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
	* CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
	* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
	* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
	* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
	* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
	* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
	* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
	* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
	* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
	* USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
	* OF SUCH DAMAGE.
	*/

	#ifndef LIBSSH2_SFTP_H
	#define LIBSSH2_SFTP_H 1

	/* Note: Version 6 was documented at the time of writing
	* However it was marked as "DO NOT IMPLEMENT" due to pending changes
	*
	* Let's start with Version 3 (The version found in OpenSSH) and go from there
	*/
	#define LIBSSH2_SFTP_VERSION 3
	#define LIBSSH2_SFTP_PACKET_MAXLEN 40000

	typedef struct _LIBSSH2_SFTP LIBSSH2_SFTP;
	typedef struct _LIBSSH2_SFTP_HANDLE LIBSSH2_SFTP_HANDLE;
	typedef struct _LIBSSH2_SFTP_ATTRIBUTES LIBSSH2_SFTP_ATTRIBUTES;

	/* Flags for open_ex() */
	#define LIBSSH2_SFTP_OPENFILE 0
	#define LIBSSH2_SFTP_OPENDIR 1

	/* Flags for rename_ex() */
	#define LIBSSH2_SFTP_RENAME_OVERWRITE 0x00000001
	#define LIBSSH2_SFTP_RENAME_ATOMIC 0x00000002
	#define LIBSSH2_SFTP_RENAME_NATIVE 0x00000004

	/* Flags for stat_ex() */
	#define LIBSSH2_SFTP_STAT 0
	#define LIBSSH2_SFTP_LSTAT 1
	#define LIBSSH2_SFTP_SETSTAT 2

	/* Flags for symlink_ex() */
	#define LIBSSH2_SFTP_SYMLINK 0
	#define LIBSSH2_SFTP_READLINK 1
	#define LIBSSH2_SFTP_REALPATH 2

	/* SFTP attribute flag bits */
	#define LIBSSH2_SFTP_ATTR_SIZE 0x00000001
	#define LIBSSH2_SFTP_ATTR_UIDGID 0x00000002
	#define LIBSSH2_SFTP_ATTR_PERMISSIONS 0x00000004
	#define LIBSSH2_SFTP_ATTR_ACMODTIME 0x00000008
	#define LIBSSH2_SFTP_ATTR_EXTENDED 0x80000000

	struct _LIBSSH2_SFTP_ATTRIBUTES {
	/* If flags & ATTR_* bit is set, then the value in this struct will be meaningful
	* Otherwise it should be ignored
	*/
	unsigned long flags;

	libssh2_uint64_t filesize;
	unsigned long uid, gid;
	unsigned long permissions;
	unsigned long atime, mtime;
	};

	/* SFTP filetypes */
	#define LIBSSH2_SFTP_TYPE_REGULAR 1
	#define LIBSSH2_SFTP_TYPE_DIRECTORY 2
	#define LIBSSH2_SFTP_TYPE_SYMLINK 3
	#define LIBSSH2_SFTP_TYPE_SPECIAL 4
	#define LIBSSH2_SFTP_TYPE_UNKNOWN 5
	#define LIBSSH2_SFTP_TYPE_SOCKET 6
	#define LIBSSH2_SFTP_TYPE_CHAR_DEVICE 7
	#define LIBSSH2_SFTP_TYPE_BLOCK_DEVICE 8
	#define LIBSSH2_SFTP_TYPE_FIFO 9

	/* SFTP File Transfer Flags -- (e.g. flags parameter to sftp_open())
	* Danger will robinson... APPEND doesn't have any effect on OpenSSH servers */
	#define LIBSSH2_FXF_READ 0x00000001
	#define LIBSSH2_FXF_WRITE 0x00000002
	#define LIBSSH2_FXF_APPEND 0x00000004
	#define LIBSSH2_FXF_CREAT 0x00000008
	#define LIBSSH2_FXF_TRUNC 0x00000010
	#define LIBSSH2_FXF_EXCL 0x00000020

	/* SFTP Status Codes (returned by libssh2_sftp_last_error() ) */
	#define LIBSSH2_FX_OK 0
	#define LIBSSH2_FX_EOF 1
	#define LIBSSH2_FX_NO_SUCH_FILE 2
	#define LIBSSH2_FX_PERMISSION_DENIED 3
	#define LIBSSH2_FX_FAILURE 4
	#define LIBSSH2_FX_BAD_MESSAGE 5
	#define LIBSSH2_FX_NO_CONNECTION 6
	#define LIBSSH2_FX_CONNECTION_LOST 7
	#define LIBSSH2_FX_OP_UNSUPPORTED 8
	#define LIBSSH2_FX_INVALID_HANDLE 9
	#define LIBSSH2_FX_NO_SUCH_PATH 10
	#define LIBSSH2_FX_FILE_ALREADY_EXISTS 11
	#define LIBSSH2_FX_WRITE_PROTECT 12
	#define LIBSSH2_FX_NO_MEDIA 13
	#define LIBSSH2_FX_NO_SPACE_ON_FILESYSTEM 14
	#define LIBSSH2_FX_QUOTA_EXCEEDED 15
	#define LIBSSH2_FX_UNKNOWN_PRINCIPLE 16
	#define LIBSSH2_FX_LOCK_CONFlICT 17
	#define LIBSSH2_FX_DIR_NOT_EMPTY 18
	#define LIBSSH2_FX_NOT_A_DIRECTORY 19
	#define LIBSSH2_FX_INVALID_FILENAME 20
	#define LIBSSH2_FX_LINK_LOOP 21

	/* SFTP API */
	LIBSSH2_API LIBSSH2_SFTP libssh2_sftp_init(LIBSSH2_SESSION session);
	LIBSSH2_API int libssh2_sftp_shutdown(LIBSSH2_SFTP *sftp);
	LIBSSH2_API unsigned long libssh2_sftp_last_error(LIBSSH2_SFTP *sftp);

	/* File / Directory Ops */
	LIBSSH2_API LIBSSH2_SFTP_HANDLE libssh2_sftp_open_ex(LIBSSH2_SFTP sftp, char *filename, int filename_len, unsigned long flags, long mode, int open_type);
	#define libssh2_sftp_open(sftp, filename, flags, mode) libssh2_sftp_open_ex((sftp), (filename), strlen(filename), (flags), (mode), LIBSSH2_SFTP_OPENFILE)
	#define libssh2_sftp_opendir(sftp, path) libssh2_sftp_open_ex((sftp), (path), strlen(path), 0, 0, LIBSSH2_SFTP_OPENDIR)

	LIBSSH2_API size_t libssh2_sftp_read(LIBSSH2_SFTP_HANDLE handle, char buffer, size_t buffer_maxlen);
	LIBSSH2_API int libssh2_sftp_readdir(LIBSSH2_SFTP_HANDLE handle, char buffer, size_t buffer_maxlen, LIBSSH2_SFTP_ATTRIBUTES *attrs);
	LIBSSH2_API size_t libssh2_sftp_write(LIBSSH2_SFTP_HANDLE handle, const char buffer, size_t count);

	LIBSSH2_API int libssh2_sftp_close_handle(LIBSSH2_SFTP_HANDLE *handle);
	#define libssh2_sftp_close(handle) libssh2_sftp_close_handle(handle)
	#define libssh2_sftp_closedir(handle) libssh2_sftp_close_handle(handle)

	LIBSSH2_API void libssh2_sftp_seek(LIBSSH2_SFTP_HANDLE *handle, size_t offset);
	#define libssh2_sftp_rewind(handle) libssh2_sftp_seek((handle), 0)

	LIBSSH2_API size_t libssh2_sftp_tell(LIBSSH2_SFTP_HANDLE *handle);

	LIBSSH2_API int libssh2_sftp_fstat_ex(LIBSSH2_SFTP_HANDLE handle, LIBSSH2_SFTP_ATTRIBUTES attrs, int setstat);
	#define libssh2_sftp_fstat(handle, attrs) libssh2_sftp_fstat_ex((handle), (attrs), 0)
	#define libssh2_sftp_fsetstat(handle, attrs) libssh2_sftp_fstat_ex((handle), (attrs), 1)



	/* Miscellaneous Ops */
	LIBSSH2_API int libssh2_sftp_rename_ex(LIBSSH2_SFTP sftp, char source_filename, int srouce_filename_len,
	char *dest_filename, int dest_filename_len,
	long flags);
	#define libssh2_sftp_rename(sftp, sourcefile, destfile) libssh2_sftp_rename_ex((sftp), (sourcefile), strlen(sourcefile), (destfile), strlen(destfile), \
	LIBSSH2_SFTP_RENAME_OVERWRITE \| LIBSSH2_SFTP_RENAME_ATOMIC \| LIBSSH2_SFTP_RENAME_NATIVE)

	LIBSSH2_API int libssh2_sftp_unlink_ex(LIBSSH2_SFTP sftp, char filename, int filename_len);
	#define libssh2_sftp_unlink(sftp, filename) libssh2_sftp_unlink_ex((sftp), (filename), strlen(filename))

	LIBSSH2_API int libssh2_sftp_mkdir_ex(LIBSSH2_SFTP sftp, char path, int path_len, long mode);
	#define libssh2_sftp_mkdir(sftp, path, mode) libssh2_sftp_mkdir_ex((sftp), (path), strlen(path), (mode))

	LIBSSH2_API int libssh2_sftp_rmdir_ex(LIBSSH2_SFTP sftp, char path, int path_len);
	#define libssh2_sftp_rmdir(sftp, path) libssh2_sftp_rmdir_ex((sftp), (path), strlen(path))

	LIBSSH2_API int libssh2_sftp_stat_ex(LIBSSH2_SFTP sftp, char path, int path_len, int stat_type, LIBSSH2_SFTP_ATTRIBUTES *attrs);
	#define libssh2_sftp_stat(sftp, path, attrs) libssh2_sftp_stat_ex((sftp), (path), strlen(path), LIBSSH2_SFTP_STAT, (attrs))
	#define libssh2_sftp_lstat(sftp, path, attrs) libssh2_sftp_stat_ex((sftp), (path), strlen(path), LIBSSH2_SFTP_LSTAT, (attrs))
	#define libssh2_sftp_setstat(sftp, path, attrs) libssh2_sftp_stat_ex((sftp), (path), strlen(path), LIBSSH2_SFTP_SETSTAT, (attrs))

	LIBSSH2_API int libssh2_sftp_symlink_ex(LIBSSH2_SFTP sftp, const char path, int path_len, char *target, int target_len, int link_type);
	#define libssh2_sftp_symlink(sftp, orig, linkpath) libssh2_sftp_symlink_ex((sftp), (orig), strlen(orig), (linkpath), strlen(linkpath), LIBSSH2_SFTP_SYMLINK)
	#define libssh2_sftp_readlink(sftp, path, target, maxlen) libssh2_sftp_symlink_ex((sftp), (path), strlen(path), (target), (maxlen), LIBSSH2_SFTP_READLINK)
	#define libssh2_sftp_realpath(sftp, path, target, maxlen) libssh2_sftp_symlink_ex((sftp), (path), strlen(path), (target), (maxlen), LIBSSH2_SFTP_REALPATH)

	#endif /* LIBSSH2_SFTP_H */