Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   16655 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

libssh2_sftp_symlink_ex(3)	libssh2 manual	    libssh2_sftp_symlink_ex(3)

NAME
       libssh2_sftp_symlink_ex - read or set a symbolic link

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

       int   libssh2_sftp_symlink_ex(LIBSSH2_SFTP  *sftp,  const  char	*path,
       unsigned int path_len,  char  *target,  unsigned	 int  target_len,  int
       link_type);

       int  libssh2_sftp_symlink(LIBSSH2_SFTP  *sftp,  const  char *path, char
       *target);

       int libssh2_sftp_readlink(LIBSSH2_SFTP *sftp, const  char  *path,  char
       *target, unsigned int target_len);

       int  libssh2_sftp_realpath(LIBSSH2_SFTP	*sftp,	const char *path, char
       *target, unsigned int target_len);

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

       path - Remote filesystem object to create a symlink from or resolve.

       path_len - Length of the name of the remote filesystem object to create
       a symlink from or resolve.

       target -
       LIBSSH2_SFTP_SYMLINK: Remote filesystem object to link to.
       LIBSSH2_SFTP_READLINK:  Pre-allocated  buffer to resolve symlink target
       into.
       LIBSSH2_SFTP_REALPATH: Pre-allocated buffer to resolve realpath	target
       into.

       target_len - Length of the name of the remote filesystem target object.

       link_type  -  One  of  the  three  previously mentioned constants which
       determines the resulting behavior of this function.

       libssh2_sftp_symlink(3) : Create a symbolic link between two filesystem
       objects.
       libssh2_sftp_readlink(3) : Resolve a symbolic link filesystem object to
       its next target.
       libssh2_sftp_realpath(3) : Resolve a complex,  relative,	 or  symlinked
       filepath to its effective target.

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.

SEE ALSO
       libssh2_sftp_init(3)

libssh2 0.15			  1 Jun 2007	    libssh2_sftp_symlink_ex(3)

Vote for polarhome