Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

libssh2_sftp_mkdir_ex (3ssh2)

Name

libssh2_sftp_mkdir_ex - create a directory on the remote file system

Synopsis

#include <libssh2.h> #include <libssh2_sftp.h>

int   libssh2_sftp_mkdir_ex(LIBSSH2_SFTP   *sftp,   const  char  *path,
unsigned int path_len, long mode);

int  libssh2_sftp_mkdir(LIBSSH2_SFTP  *sftp,  const  char  *path,  long
mode);

Description

libssh2 manual                                    libssh2_sftp_mkdir_ex(3ssh2)



NAME
       libssh2_sftp_mkdir_ex - create a directory on the remote file system

SYNOPSIS
       #include <libssh2.h> #include <libssh2_sftp.h>

       int   libssh2_sftp_mkdir_ex(LIBSSH2_SFTP   *sftp,   const  char  *path,
       unsigned int path_len, long mode);

       int  libssh2_sftp_mkdir(LIBSSH2_SFTP  *sftp,  const  char  *path,  long
       mode);

DESCRIPTION
       sftp - SFTP instance as returned by libssh2_sftp_init(3)

       path  -  full  path  of  the new directory to create. Note that the new
       directory's parents must all exist prior to making this call.

       path_len - length of the full path of the new directory to create.

       mode - directory creation mode (e.g. 0755).

       Create a directory on the remote file system.

RETURN VALUE
       Return 0 on success or negative on failure.  LIBSSH2_ERROR_EAGAIN  when
       it would otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative num-
       ber, it isn't really a failure per se.

ERRORS
       LIBSSH2_ERROR_ALLOC -  An internal memory allocation call failed.

       LIBSSH2_ERROR_SOCKET_SEND - Unable to send data on socket.

       LIBSSH2_ERROR_SOCKET_TIMEOUT -

       LIBSSH2_ERROR_SFTP_PROTOCOL - An invalid  SFTP  protocol  response  was
       received  on the socket, or an SFTP operation caused an errorcode to be
       returned by the server.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/libssh2  |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

SEE ALSO
       libssh2_sftp_open_ex(3)



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source  was  downloaded   from    https://www.libssh2.org/download/lib-
       ssh2-1.10.0.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.libssh2.org/.



libssh2 0.15                      1 Jun 2007
                                                  libssh2_sftp_mkdir_ex(3ssh2)