Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

libssh2_sftp_close_handle (3ssh2)

Name

libssh2_sftp_close_handle - close filehandle

Synopsis

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

int libssh2_sftp_close_handle(LIBSSH2_SFTP_HANDLE *handle);

int libssh2_sftp_close(LIBSSH2_SFTP_HANDLE *handle);

int libssh2_sftp_closedir(LIBSSH2_SFTP_HANDLE *handle);

Description

libssh2 manual                                libssh2_sftp_close_handle(3ssh2)



NAME
       libssh2_sftp_close_handle - close filehandle

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

       int libssh2_sftp_close_handle(LIBSSH2_SFTP_HANDLE *handle);

       int libssh2_sftp_close(LIBSSH2_SFTP_HANDLE *handle);

       int libssh2_sftp_closedir(LIBSSH2_SFTP_HANDLE *handle);


DESCRIPTION
       handle  -  SFTP  File  Handle as returned by libssh2_sftp_open_ex(3) or
       libssh2_sftp_opendir(3) (which is a macro).

       Close an active  LIBSSH2_SFTP_HANDLE.  Because  files  and  directories
       share  the  same underlying storage mechanism these methods may be used
       interchangeably. libssh2_sftp_close(3) and libssh2_sftp_closedir(3) are
       macros for libssh2_sftp_close_handle(3).


RETURN VALUE
       Return   0  on  success  or  negative  on  failure.   It  returns  LIB-
       SSH2_ERROR_EAGAIN  when  it   would   otherwise   block.   While   LIB-
       SSH2_ERROR_EAGAIN  is  a negative number, 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_close_handle(3ssh2)