module libssh.c_bindings.sftp;

import libssh.c_bindings.libssh;
import libssh.c_bindings.ctypes;

version(Windows)
{
	public import core.stdc.stdio;
    enum S_IRUSR    = 0x100;  // octal 0400
    enum S_IWUSR    = 0x080;  // octal 0200
    enum S_IXUSR    = 0x040;  // octal 0100
    enum S_IRWXU    = S_IRUSR | S_IWUSR | S_IXUSR;

    enum S_IRGRP    = S_IRUSR >> 3;
    enum S_IWGRP    = S_IWUSR >> 3;
    enum S_IXGRP    = S_IXUSR >> 3;
    enum S_IRWXG    = S_IRWXU >> 3;

    enum S_IROTH    = S_IRGRP >> 3;
    enum S_IWOTH    = S_IWGRP >> 3;
    enum S_IXOTH    = S_IXGRP >> 3;
    enum S_IRWXO    = S_IRWXG >> 3;

    enum S_ISUID    = 0x800; // octal 04000
    enum S_ISGID    = 0x400; // octal 02000
}
else
{
	public import core.sys.posix.fcntl;
}

enum auto LIBSFTP_VERSION = 3;

struct sftp_ext_struct { }

alias sftp_attributes = sftp_attributes_struct*;
alias sftp_client_message = sftp_client_message_struct*;
alias sftp_dir = sftp_dir_struct*;
alias sftp_ext = sftp_ext_struct*;
alias sftp_file = sftp_file_struct*;
alias sftp_message = sftp_message_struct*;
alias sftp_packet = sftp_packet_struct*;
alias sftp_request_queue = sftp_request_queue_struct*;
alias sftp_session = sftp_session_struct*;
alias sftp_status_message = sftp_status_message_struct*;
alias sftp_statvfs_t = sftp_statvfs_struct*;

struct sftp_session_struct {
    ssh_session session;
    ssh_channel channel;
    int server_version;
    int client_version;
    int version_;
    sftp_request_queue queue;
    uint id_counter;
    int errnum;
    void **handles;
    sftp_ext ext;
};

struct sftp_packet_struct {
    sftp_session sftp;
    ubyte type;
    ssh_buffer payload;
};

/* file handler */
struct sftp_file_struct {
    sftp_session sftp;
    char *name;
    ulong offset;
    ssh_string handle;
    int eof;
    int nonblocking;
};

struct sftp_dir_struct {
    sftp_session sftp;
    char *name;
    ssh_string handle; /* handle to directory */
    ssh_buffer buffer; /* contains raw attributes from server which haven't been parsed */
    uint count; /* counts the number of following attributes structures into buffer */
    int eof; /* end of directory listing */
};

struct sftp_message_struct {
    sftp_session sftp;
    ubyte packet_type;
    ssh_buffer payload;
    uint id;
};

/* this is a bunch of all data that could be into a message */
struct sftp_client_message_struct {
    sftp_session sftp;
    ubyte type;
    uint id;
    char *filename; /* can be "path" */
    uint flags;
    sftp_attributes attr;
    ssh_string handle;
    ulong offset;
    uint len;
    int attr_num;
    ssh_buffer attrbuf; /* used by sftp_reply_attrs */
    ssh_string data; /* can be newpath of rename() */
    ssh_buffer complete_message; /* complete message in case of retransmission*/
    char *str_data; /* cstring version of data */
};

struct sftp_request_queue_struct {
    sftp_request_queue next;
    sftp_message message;
};

/* SSH_FXP_MESSAGE described into .7 page 26 */
struct sftp_status_message_struct {
    uint id;
    uint status;
    ssh_string error_unused; /* not used anymore */
    ssh_string lang_unused;  /* not used anymore */
    char *errormsg;
    char *langmsg;
};

struct sftp_attributes_struct {
    char *name;
    char *longname; /* ls -l output on openssh, not reliable else */
    uint flags;
    ubyte type;
    ulong size;
    uint uid;
    uint gid;
    char *owner; /* set if openssh and version 4 */
    char *group; /* set if openssh and version 4 */
    uint permissions;
    ulong atime64;
    uint atime;
    uint atime_nseconds;
    ulong createtime;
    uint createtime_nseconds;
    ulong mtime64;
    uint mtime;
    uint mtime_nseconds;
    ssh_string acl;
    uint extended_count;
    ssh_string extended_type;
    ssh_string extended_data;
};

/**
 * @brief SFTP statvfs structure.
 */
struct sftp_statvfs_struct {
    ulong f_bsize;   /** file system block size */
    ulong f_frsize;  /** fundamental fs block size */
    ulong f_blocks;  /** number of blocks (unit f_frsize) */
    ulong f_bfree;   /** free blocks in file system */
    ulong f_bavail;  /** free blocks for non-root */
    ulong f_files;   /** total file inodes */
    ulong f_ffree;   /** free file inodes */
    ulong f_favail;  /** free file inodes for to non-root */
    ulong f_fsid;    /** file system id */
    ulong f_flag;    /** bit mask of f_flag values */
    ulong f_namemax; /** maximum filename length */
};

extern(C) {
    /**
    * @brief Start a new sftp session.
    *
    * @param session       The ssh session to use.
    *
    * @return              A new sftp session or NULL on error.
    *
    * @see sftp_free()
    */
    sftp_session sftp_new(ssh_session session);

    /**
    * @brief Start a new sftp session with an existing channel.
    *
    * @param session       The ssh session to use.
    * @param channel       An open session channel with subsystem already allocated
    *
    * @return              A new sftp session or NULL on error.
    *
    * @see sftp_free()
    */
    sftp_session sftp_new_channel(ssh_session session, ssh_channel channel);


    /**
    * @brief Close and deallocate a sftp session.
    *
    * @param sftp          The sftp session handle to free.
    */
    void sftp_free(sftp_session sftp);

    /**
    * @brief Initialize the sftp session with the server.
    *
    * @param sftp          The sftp session to initialize.
    *
    * @return              0 on success, < 0 on error with ssh error set.
    *
    * @see sftp_new()
    */
    int sftp_init(sftp_session sftp);

    /**
    * @brief Get the last sftp error.
    *
    * Use this function to get the latest error set by a posix like sftp function.
    *
    * @param sftp          The sftp session where the error is saved.
    *
    * @return              The saved error (see server responses), < 0 if an error
    *                      in the function occured.
    *
    * @see Server responses
    */
    int sftp_get_error(sftp_session sftp);

    /**
    * @brief Get the count of extensions provided by the server.
    *
    * @param  sftp         The sftp session to use.
    *
    * @return The count of extensions provided by the server, 0 on error or
    *         not available.
    */
    uint sftp_extensions_get_count(sftp_session sftp);

    /**
    * @brief Get the name of the extension provided by the server.
    *
    * @param  sftp         The sftp session to use.
    *
    * @param  indexn        The index number of the extension name you want.
    *
    * @return              The name of the extension.
    */
    const(char) *sftp_extensions_get_name(sftp_session sftp, uint indexn);

    /**
    * @brief Get the data of the extension provided by the server.
    *
    * This is normally the version number of the extension.
    *
    * @param  sftp         The sftp session to use.
    *
    * @param  indexn        The index number of the extension data you want.
    *
    * @return              The data of the extension.
    */
    const(char) *sftp_extensions_get_data(sftp_session sftp, uint indexn);

    /**
    * @brief Check if the given extension is supported.
    *
    * @param  sftp         The sftp session to use.
    *
    * @param  name         The name of the extension.
    *
    * @param  data         The data of the extension.
    *
    * @return 1 if supported, 0 if not.
    *
    * Example:
    *
    * @code
    * sftp_extension_supported(sftp, "statvfs@openssh.com", "2");
    * @endcode
    */
    int sftp_extension_supported(sftp_session sftp, const char *name,
        const char *data);

    /**
    * @brief Open a directory used to obtain directory entries.
    *
    * @param session       The sftp session handle to open the directory.
    * @param path          The path of the directory to open.
    *
    * @return              A sftp directory handle or NULL on error with ssh and
    *                      sftp error set.
    *
    * @see                 sftp_readdir
    * @see                 sftp_closedir
    */
    sftp_dir sftp_opendir(sftp_session session, const char *path);

    /**
    * @brief Get a single file attributes structure of a directory.
    *
    * @param session      The sftp session handle to read the directory entry.
    * @param dir          The opened sftp directory handle to read from.
    *
    * @return             A file attribute structure or NULL at the end of the
    *                     directory.
    *
    * @see                sftp_opendir()
    * @see                sftp_attribute_free()
    * @see                sftp_closedir()
    */
    sftp_attributes sftp_readdir(sftp_session session, sftp_dir dir);

    /**
    * @brief Tell if the directory has reached EOF (End Of File).
    *
    * @param dir           The sftp directory handle.
    *
    * @return              1 if the directory is EOF, 0 if not.
    *
    * @see                 sftp_readdir()
    */
    int sftp_dir_eof(sftp_dir dir);

    /**
    * @brief Get information about a file or directory.
    *
    * @param session       The sftp session handle.
    * @param path          The path to the file or directory to obtain the
    *                      information.
    *
    * @return              The sftp attributes structure of the file or directory,
    *                      NULL on error with ssh and sftp error set.
    *
    * @see sftp_get_error()
    */
    sftp_attributes sftp_stat(sftp_session session, const char *path);

    /**
    * @brief Get information about a file or directory.
    *
    * Identical to sftp_stat, but if the file or directory is a symbolic link,
    * then the link itself is stated, not the file that it refers to.
    *
    * @param session       The sftp session handle.
    * @param path          The path to the file or directory to obtain the
    *                      information.
    *
    * @return              The sftp attributes structure of the file or directory,
    *                      NULL on error with ssh and sftp error set.
    *
    * @see sftp_get_error()
    */
    sftp_attributes sftp_lstat(sftp_session session, const char *path);

    /**
    * @brief Get information about a file or directory from a file handle.
    *
    * @param file          The sftp file handle to get the stat information.
    *
    * @return              The sftp attributes structure of the file or directory,
    *                      NULL on error with ssh and sftp error set.
    *
    * @see sftp_get_error()
    */
    sftp_attributes sftp_fstat(sftp_file file);

    /**
    * @brief Free a sftp attribute structure.
    *
    * @param file          The sftp attribute structure to free.
    */
    void sftp_attributes_free(sftp_attributes file);

    /**
    * @brief Close a directory handle opened by sftp_opendir().
    *
    * @param dir           The sftp directory handle to close.
    *
    * @return              Returns SSH_NO_ERROR or SSH_ERROR if an error occured.
    */
    int sftp_closedir(sftp_dir dir);

    /**
    * @brief Close an open file handle.
    *
    * @param file          The open sftp file handle to close.
    *
    * @return              Returns SSH_NO_ERROR or SSH_ERROR if an error occured.
    *
    * @see                 sftp_open()
    */
    int sftp_close(sftp_file file);

    /**
    * @brief Open a file on the server.
    *
    * @param session       The sftp session handle.
    *
    * @param file          The file to be opened.
    *
    * @param accesstype    Is one of O_RDONLY, O_WRONLY or O_RDWR which request
    *                      opening  the  file  read-only,write-only or read/write.
    *                      Acesss may also be bitwise-or'd with one or  more of
    *                      the following:
    *                      O_CREAT - If the file does not exist it will be
    *                      created.
    *                      O_EXCL - When  used with O_CREAT, if the file already
    *                      exists it is an error and the open will fail.
    *                      O_TRUNC - If the file already exists it will be
    *                      truncated.
    *
    * @param mode          Mode specifies the permissions to use if a new file is
    *                      created.  It  is  modified  by  the process's umask in
    *                      the usual way: The permissions of the created file are
    *                      (mode & ~umask)
    *
    * @return              A sftp file handle, NULL on error with ssh and sftp
    *                      error set.
    *
    * @see sftp_get_error()
    */
    sftp_file sftp_open(sftp_session session, const char *file, int accesstype,
        mode_t mode);

    /**
    * @brief Make the sftp communication for this file handle non blocking.
    *
    * @param[in]  handle   The file handle to set non blocking.
    */
    void sftp_file_set_nonblocking(sftp_file handle);

    /**
    * @brief Make the sftp communication for this file handle blocking.
    *
    * @param[in]  handle   The file handle to set blocking.
    */
    void sftp_file_set_blocking(sftp_file handle);

    /**
    * @brief Read from a file using an opened sftp file handle.
    *
    * @param file          The opened sftp file handle to be read from.
    *
    * @param buf           Pointer to buffer to recieve read data.
    *
    * @param count         Size of the buffer in bytes.
    *
    * @return              Number of bytes written, < 0 on error with ssh and sftp
    *                      error set.
    *
    * @see sftp_get_error()
    */
    ptrdiff_t sftp_read(sftp_file file, void *buf, size_t count);

    /**
    * @brief Start an asynchronous read from a file using an opened sftp file handle.
    *
    * Its goal is to avoid the slowdowns related to the request/response pattern
    * of a synchronous read. To do so, you must call 2 functions:
    *
    * sftp_async_read_begin() and sftp_async_read().
    *
    * The first step is to call sftp_async_read_begin(). This function returns a
    * request identifier. The second step is to call sftp_async_read() using the
    * returned identifier.
    *
    * @param file          The opened sftp file handle to be read from.
    *
    * @param len           Size to read in bytes.
    *
    * @return              An identifier corresponding to the sent request, < 0 on
    *                      error.
    *
    * @warning             When calling this function, the internal offset is
    *                      updated corresponding to the len parameter.
    *
    * @warning             A call to sftp_async_read_begin() sends a request to
    *                      the server. When the server answers, libssh allocates
    *                      memory to store it until sftp_async_read() is called.
    *                      Not calling sftp_async_read() will lead to memory
    *                      leaks.
    *
    * @see                 sftp_async_read()
    * @see                 sftp_open()
    */
    int sftp_async_read_begin(sftp_file file, uint len);

    /**
    * @brief Wait for an asynchronous read to complete and save the data.
    *
    * @param file          The opened sftp file handle to be read from.
    *
    * @param data          Pointer to buffer to recieve read data.
    *
    * @param len           Size of the buffer in bytes. It should be bigger or
    *                      equal to the length parameter of the
    *                      sftp_async_read_begin() call.
    *
    * @param id            The identifier returned by the sftp_async_read_begin()
    *                      function.
    *
    * @return              Number of bytes read, 0 on EOF, SSH_ERROR if an error
    *                      occured, SSH_AGAIN if the file is opened in nonblocking
    *                      mode and the request hasn't been executed yet.
    *
    * @warning             A call to this function with an invalid identifier
    *                      will never return.
    *
    * @see sftp_async_read_begin()
    */
    int sftp_async_read(sftp_file file, void *data, uint len, uint id);

    /**
    * @brief Write to a file using an opened sftp file handle.
    *
    * @param file          Open sftp file handle to write to.
    *
    * @param buf           Pointer to buffer to write data.
    *
    * @param count         Size of buffer in bytes.
    *
    * @return              Number of bytes written, < 0 on error with ssh and sftp
    *                      error set.
    *
    * @see                 sftp_open()
    * @see                 sftp_read()
    * @see                 sftp_close()
    */
    ptrdiff_t sftp_write(sftp_file file, const void *buf, size_t count);

    /**
    * @brief Seek to a specific location in a file.
    *
    * @param file         Open sftp file handle to seek in.
    *
    * @param new_offset   Offset in bytes to seek.
    *
    * @return             0 on success, < 0 on error.
    */
    int sftp_seek(sftp_file file, uint new_offset);

    /**
    * @brief Seek to a specific location in a file. This is the
    * 64bit version.
    *
    * @param file         Open sftp file handle to seek in.
    *
    * @param new_offset   Offset in bytes to seek.
    *
    * @return             0 on success, < 0 on error.
    */
    int sftp_seek64(sftp_file file, ulong new_offset);

    /**
    * @brief Report current byte position in file.
    *
    * @param file          Open sftp file handle.
    *
    * @return              The offset of the current byte relative to the beginning
    *                      of the file associated with the file descriptor. < 0 on
    *                      error.
    */
    uint sftp_tell(sftp_file file);

    /**
    * @brief Report current byte position in file.
    *
    * @param file          Open sftp file handle.
    *
    * @return              The offset of the current byte relative to the beginning
    *                      of the file associated with the file descriptor. < 0 on
    *                      error.
    */
    ulong sftp_tell64(sftp_file file);

    /**
    * @brief Rewinds the position of the file pointer to the beginning of the
    * file.
    *
    * @param file          Open sftp file handle.
    */
    void sftp_rewind(sftp_file file);

    /**
    * @brief Unlink (delete) a file.
    *
    * @param sftp          The sftp session handle.
    *
    * @param file          The file to unlink/delete.
    *
    * @return              0 on success, < 0 on error with ssh and sftp error set.
    *
    * @see sftp_get_error()
    */
    int sftp_unlink(sftp_session sftp, const char *file);

    /**
    * @brief Remove a directoy.
    *
    * @param sftp          The sftp session handle.
    *
    * @param directory     The directory to remove.
    *
    * @return              0 on success, < 0 on error with ssh and sftp error set.
    *
    * @see sftp_get_error()
    */
    int sftp_rmdir(sftp_session sftp, const char *directory);

    /**
    * @brief Create a directory.
    *
    * @param sftp          The sftp session handle.
    *
    * @param directory     The directory to create.
    *
    * @param mode          Specifies the permissions to use. It is modified by the
    *                      process's umask in the usual way:
    *                      The permissions of the created file are (mode & ~umask)
    *
    * @return              0 on success, < 0 on error with ssh and sftp error set.
    *
    * @see sftp_get_error()
    */
    int sftp_mkdir(sftp_session sftp, const char *directory, mode_t mode);

    /**
    * @brief Rename or move a file or directory.
    *
    * @param sftp          The sftp session handle.
    *
    * @param original      The original url (source url) of file or directory to
    *                      be moved.
    *
    * @param newname       The new url (destination url) of the file or directory
    *                      after the move.
    *
    * @return              0 on success, < 0 on error with ssh and sftp error set.
    *
    * @see sftp_get_error()
    */
    int sftp_rename(sftp_session sftp, const char *original, const  char *newname);

    /**
    * @brief Set file attributes on a file, directory or symbolic link.
    *
    * @param sftp          The sftp session handle.
    *
    * @param file          The file which attributes should be changed.
    *
    * @param attr          The file attributes structure with the attributes set
    *                      which should be changed.
    *
    * @return              0 on success, < 0 on error with ssh and sftp error set.
    *
    * @see sftp_get_error()
    */
    int sftp_setstat(sftp_session sftp, const char *file, sftp_attributes attr);

    /**
    * @brief Change the file owner and group
    *
    * @param sftp          The sftp session handle.
    *
    * @param file          The file which owner and group should be changed.
    *
    * @param owner         The new owner which should be set.
    *
    * @param group         The new group which should be set.
    *
    * @return              0 on success, < 0 on error with ssh and sftp error set.
    *
    * @see sftp_get_error()
    */
    int sftp_chown(sftp_session sftp, const char *file, uid_t owner, gid_t group);

    /**
    * @brief Change permissions of a file
    *
    * @param sftp          The sftp session handle.
    *
    * @param file          The file which owner and group should be changed.
    *
    * @param mode          Specifies the permissions to use. It is modified by the
    *                      process's umask in the usual way:
    *                      The permissions of the created file are (mode & ~umask)
    *
    * @return              0 on success, < 0 on error with ssh and sftp error set.
    *
    * @see sftp_get_error()
    */
    int sftp_chmod(sftp_session sftp, const char *file, mode_t mode);

    /**
    * @brief Change the last modification and access time of a file.
    *
    * @param sftp          The sftp session handle.
    *
    * @param file          The file which owner and group should be changed.
    *
    * @param times         A timeval structure which contains the desired access
    *                      and modification time.
    *
    * @return              0 on success, < 0 on error with ssh and sftp error set.
    *
    * @see sftp_get_error()
    */
    int sftp_utimes(sftp_session sftp, const char *file, const timeval *times);

    /**
    * @brief Create a symbolic link.
    *
    * @param  sftp         The sftp session handle.
    *
    * @param  target       Specifies the target of the symlink.
    *
    * @param  dest         Specifies the path name of the symlink to be created.
    *
    * @return              0 on success, < 0 on error with ssh and sftp error set.
    *
    * @see sftp_get_error()
    */
    int sftp_symlink(sftp_session sftp, const char *target, const char *dest);

    /**
    * @brief Read the value of a symbolic link.
    *
    * @param  sftp         The sftp session handle.
    *
    * @param  path         Specifies the path name of the symlink to be read.
    *
    * @return              The target of the link, NULL on error.
    *
    * @see sftp_get_error()
    */
    char *sftp_readlink(sftp_session sftp, const char *path);

    /**
    * @brief Get information about a mounted file system.
    *
    * @param  sftp         The sftp session handle.
    *
    * @param  path         The pathname of any file within the mounted file system.
    *
    * @return A statvfs structure or NULL on error.
    *
    * @see sftp_get_error()
    */
    sftp_statvfs_t sftp_statvfs(sftp_session sftp, const char *path);

    /**
    * @brief Get information about a mounted file system.
    *
    * @param  file         An opened file.
    *
    * @return A statvfs structure or NULL on error.
    *
    * @see sftp_get_error()
    */
    sftp_statvfs_t sftp_fstatvfs(sftp_file file);

    /**
    * @brief Free the memory of an allocated statvfs.
    *
    * @param  statvfs_o      The statvfs to free.
    */
    void sftp_statvfs_free(sftp_statvfs_t statvfs_o);

    /**
    * @brief Canonicalize a sftp path.
    *
    * @param sftp          The sftp session handle.
    *
    * @param path          The path to be canonicalized.
    *
    * @return              The canonicalize path, NULL on error.
    */
    char *sftp_canonicalize_path(sftp_session sftp, const char *path);

    /**
    * @brief Get the version of the SFTP protocol supported by the server
    *
    * @param sftp          The sftp session handle.
    *
    * @return              The server version.
    */
    int sftp_server_version(sftp_session sftp);

    version (LIBSSH_WITH_SERVER) {
        /**
        * @brief Create a new sftp server session.
        *
        * @param session       The ssh session to use.
        *
        * @param chan          The ssh channel to use.
        *
        * @return              A new sftp server session.
        */
        sftp_session sftp_server_new(ssh_session session, ssh_channel chan);

        /**
        * @brief Intialize the sftp server.
        *
        * @param sftp         The sftp session to init.
        *
        * @return             0 on success, < 0 on error.
        */
        int sftp_server_init(sftp_session sftp);
    }

//    /* this is not a public interface */
//    #define SFTP_HANDLES 256
//    sftp_packet sftp_packet_read(sftp_session sftp);
//    int sftp_packet_write(sftp_session sftp,uint8_t type, ssh_buffer payload);
//    void sftp_packet_free(sftp_packet packet);
//    int buffer_add_attributes(ssh_buffer buffer, sftp_attributes attr);
//    sftp_attributes sftp_parse_attr(sftp_session session, ssh_buffer buf,int expectname);
//    /* sftpserver.c */
//    
//    LIBSSH_API sftp_client_message sftp_get_client_message(sftp_session sftp);
//    LIBSSH_API void sftp_client_message_free(sftp_client_message msg);
//    LIBSSH_API uint8_t sftp_client_message_get_type(sftp_client_message msg);
//    LIBSSH_API const char *sftp_client_message_get_filename(sftp_client_message msg);
//    LIBSSH_API void sftp_client_message_set_filename(sftp_client_message msg, const char *newname);
//    LIBSSH_API const char *sftp_client_message_get_data(sftp_client_message msg);
//    LIBSSH_API uint32_t sftp_client_message_get_flags(sftp_client_message msg);
//    LIBSSH_API int sftp_send_client_message(sftp_session sftp, sftp_client_message msg);
//    int sftp_reply_name(sftp_client_message msg, const char *name,
//        sftp_attributes attr);
//    int sftp_reply_handle(sftp_client_message msg, ssh_string handle);
//    ssh_string sftp_handle_alloc(sftp_session sftp, void *info);
//    int sftp_reply_attr(sftp_client_message msg, sftp_attributes attr);
//    void *sftp_handle(sftp_session sftp, ssh_string handle);
//    int sftp_reply_status(sftp_client_message msg, uint32_t status, const char *message);
//    int sftp_reply_names_add(sftp_client_message msg, const char *file,
//        const char *longname, sftp_attributes attr);
//    int sftp_reply_names(sftp_client_message msg);
//    int sftp_reply_data(sftp_client_message msg, const void *data, int len);
//    void sftp_handle_remove(sftp_session sftp, void *handle);
}

/* SFTP commands and constants */
enum auto SSH_FXP_INIT = 1;
enum auto SSH_FXP_VERSION = 2;
enum auto SSH_FXP_OPEN = 3;
enum auto SSH_FXP_CLOSE = 4;
enum auto SSH_FXP_READ = 5;
enum auto SSH_FXP_WRITE = 6;
enum auto SSH_FXP_LSTAT = 7;
enum auto SSH_FXP_FSTAT = 8;
enum auto SSH_FXP_SETSTAT = 9;
enum auto SSH_FXP_FSETSTAT = 10;
enum auto SSH_FXP_OPENDIR = 11;
enum auto SSH_FXP_READDIR = 12;
enum auto SSH_FXP_REMOVE = 13;
enum auto SSH_FXP_MKDIR = 14;
enum auto SSH_FXP_RMDIR = 15;
enum auto SSH_FXP_REALPATH = 16;
enum auto SSH_FXP_STAT = 17;
enum auto SSH_FXP_RENAME = 18;
enum auto SSH_FXP_READLINK = 19;
enum auto SSH_FXP_SYMLINK = 20;

enum auto SSH_FXP_STATUS = 101;
enum auto SSH_FXP_HANDLE = 102;
enum auto SSH_FXP_DATA = 103;
enum auto SSH_FXP_NAME = 104;
enum auto SSH_FXP_ATTRS = 105;

enum auto SSH_FXP_EXTENDED = 200;
enum auto SSH_FXP_EXTENDED_REPLY = 201;

/* attributes */
/* sftp draft is completely braindead : version 3 and 4 have different flags for same constants */
/* and even worst, version 4 has same flag for 2 different constants */
/* follow up : i won't develop any sftp4 compliant library before having a clarification */

enum auto SSH_FILEXFER_ATTR_SIZE = 0x00000001;
enum auto SSH_FILEXFER_ATTR_PERMISSIONS = 0x00000004;
enum auto SSH_FILEXFER_ATTR_ACCESSTIME = 0x00000008;
enum auto SSH_FILEXFER_ATTR_ACMODTIME =  0x00000008;
enum auto SSH_FILEXFER_ATTR_CREATETIME = 0x00000010;
enum auto SSH_FILEXFER_ATTR_MODIFYTIME = 0x00000020;
enum auto SSH_FILEXFER_ATTR_ACL = 0x00000040;
enum auto SSH_FILEXFER_ATTR_OWNERGROUP = 0x00000080;
enum auto SSH_FILEXFER_ATTR_SUBSECOND_TIMES = 0x00000100;
enum auto SSH_FILEXFER_ATTR_EXTENDED = 0x80000000;
enum auto SSH_FILEXFER_ATTR_UIDGID = 0x00000002;

/* types */
enum auto SSH_FILEXFER_TYPE_REGULAR = 1;
enum auto SSH_FILEXFER_TYPE_DIRECTORY = 2;
enum auto SSH_FILEXFER_TYPE_SYMLINK = 3;
enum auto SSH_FILEXFER_TYPE_SPECIAL = 4;
enum auto SSH_FILEXFER_TYPE_UNKNOWN = 5;

/**
 * @name Server responses
 *
 * @brief Responses returned by the sftp server.
 * @{
 */

/** No error */
enum auto SSH_FX_OK = 0;
/** End-of-file encountered */
enum auto SSH_FX_EOF = 1;
/** File doesn't exist */
enum auto SSH_FX_NO_SUCH_FILE = 2;
/** Permission denied */
enum auto SSH_FX_PERMISSION_DENIED = 3;
/** Generic failure */
enum auto SSH_FX_FAILURE = 4;
/** Garbage received from server */
enum auto SSH_FX_BAD_MESSAGE = 5;
/** No connection has been set up */
enum auto SSH_FX_NO_CONNECTION = 6;
/** There was a connection, but we lost it */
enum auto SSH_FX_CONNECTION_LOST = 7;
/** Operation not supported by the server */
enum auto SSH_FX_OP_UNSUPPORTED = 8;
/** Invalid file handle */
enum auto SSH_FX_INVALID_HANDLE = 9;
/** No such file or directory path exists */
enum auto SSH_FX_NO_SUCH_PATH = 10;
/** An attempt to create an already existing file or directory has been made */
enum auto SSH_FX_FILE_ALREADY_EXISTS = 11;
/** We are trying to write on a write-protected filesystem */
enum auto SSH_FX_WRITE_PROTECT = 12;
/** No media in remote drive */
enum auto SSH_FX_NO_MEDIA = 13;

/** @} */

/* file flags */
enum auto SSH_FXF_READ = 0x01;
enum auto SSH_FXF_WRITE = 0x02;
enum auto SSH_FXF_APPEND = 0x04;
enum auto SSH_FXF_CREAT = 0x08;
enum auto SSH_FXF_TRUNC = 0x10;
enum auto SSH_FXF_EXCL = 0x20;
enum auto SSH_FXF_TEXT = 0x40;

/* rename flags */
enum auto SSH_FXF_RENAME_OVERWRITE =  0x00000001;
enum auto SSH_FXF_RENAME_ATOMIC =     0x00000002;
enum auto SSH_FXF_RENAME_NATIVE =     0x00000004;

enum auto SFTP_OPEN = SSH_FXP_OPEN;
enum auto SFTP_CLOSE = SSH_FXP_CLOSE;
enum auto SFTP_READ = SSH_FXP_READ;
enum auto SFTP_WRITE = SSH_FXP_WRITE;
enum auto SFTP_LSTAT = SSH_FXP_LSTAT;
enum auto SFTP_FSTAT = SSH_FXP_FSTAT;
enum auto SFTP_SETSTAT = SSH_FXP_SETSTAT;
enum auto SFTP_FSETSTAT = SSH_FXP_FSETSTAT;
enum auto SFTP_OPENDIR = SSH_FXP_OPENDIR;
enum auto SFTP_READDIR = SSH_FXP_READDIR;
enum auto SFTP_REMOVE = SSH_FXP_REMOVE;
enum auto SFTP_MKDIR = SSH_FXP_MKDIR;
enum auto SFTP_RMDIR = SSH_FXP_RMDIR;
enum auto SFTP_REALPATH = SSH_FXP_REALPATH;
enum auto SFTP_STAT = SSH_FXP_STAT;
enum auto SFTP_RENAME = SSH_FXP_RENAME;
enum auto SFTP_READLINK = SSH_FXP_READLINK;
enum auto SFTP_SYMLINK = SSH_FXP_SYMLINK;

/* openssh flags */
enum auto SSH_FXE_STATVFS_ST_RDONLY = 0x1; /* read-only */
enum auto SSH_FXE_STATVFS_ST_NOSUID = 0x2; /* no setuid */