geom_gate userland utility improvements
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 

40 lines
1.3 KiB

  1. .TH libssh2_sftp_fsync 3 "8 Apr 2013" "libssh2 1.4.4" "libssh2 manual"
  2. .SH NAME
  3. libssh2_sftp_fsync - synchronize file to disk
  4. .SH SYNOPSIS
  5. .nf
  6. #include <libssh2.h>
  7. #include <libssh2_sftp.h>
  8. int
  9. libssh2_sftp_fsync(LIBSSH2_SFTP_HANDLE *handle)
  10. .fi
  11. .SH DESCRIPTION
  12. This function causes the remote server to synchronize the file
  13. data and metadata to disk (like fsync(2)).
  14. For this to work requires fsync@openssh.com support on the server.
  15. \fIhandle\fP - SFTP File Handle as returned by
  16. .BR libssh2_sftp_open_ex(3)
  17. .SH RETURN VALUE
  18. Returns 0 on success or negative on failure. If used in non-blocking mode, it
  19. returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
  20. LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se.
  21. .SH ERRORS
  22. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.
  23. \fILIBSSH2_ERROR_SOCKET_SEND\fP - Unable to send data on socket.
  24. \fILIBSSH2_ERROR_SFTP_PROTOCOL\fP - An invalid SFTP protocol response
  25. was received on the socket, or an SFTP operation caused an errorcode
  26. to be returned by the server. In particular, this can be returned if
  27. the SSH server does not support the fsync operation: the SFTP subcode
  28. \fILIBSSH2_FX_OP_UNSUPPORTED\fP will be returned in this case.
  29. .SH AVAILABILITY
  30. Added in libssh2 1.4.4 and OpenSSH 6.3.
  31. .SH SEE ALSO
  32. .BR fsync(2)