From 4ddd4e856a43c800227878c4b145aca15ce3f579 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= Date: Wed, 14 Nov 2018 12:50:22 +0100 Subject: Ranch 1.7.0 --- .../1.7/manual/ranch_transport.sendfile/index.html | 206 +++++++++++++++++++++ 1 file changed, 206 insertions(+) create mode 100644 docs/en/ranch/1.7/manual/ranch_transport.sendfile/index.html (limited to 'docs/en/ranch/1.7/manual/ranch_transport.sendfile/index.html') diff --git a/docs/en/ranch/1.7/manual/ranch_transport.sendfile/index.html b/docs/en/ranch/1.7/manual/ranch_transport.sendfile/index.html new file mode 100644 index 00000000..96478501 --- /dev/null +++ b/docs/en/ranch/1.7/manual/ranch_transport.sendfile/index.html @@ -0,0 +1,206 @@ + + + + + + + + + + Nine Nines: ranch_transport:sendfile(3) + + + + + + + + + + + + + + +
+
+
+
+

99s

+
+
+ +
+ +
    +
  • + Github +
    • +
  • + +
    • +
+
+
+
+
+ + +
+ +
+
+
+
+ +

ranch_transport:sendfile(3)

+ +

Name

+

ranch_transport:sendfile - Send a file on the socket

+

Description

+
+
sendfile(Transport :: module(),
+         Socket    :: ranch_transport:socket(),
+         File      :: file:name_all() | file:fd(),
+         Offset    :: non_neg_integer(),
+         Bytes     :: non_neg_integer(),
+         Opts      :: ranch_transport:sendfile_opts())
+    -> {ok, SentBytes :: non_neg_integer()} | {error, atom()}
+
+

Send a file on the socket.

+

The file may be sent full or in parts, and may be specified by its filename or by an already open file descriptor.

+

This function emulates the function file:sendfile/2,4,5 and may be used when transports are not manipulating TCP directly.

+

Arguments

+
Transport
+

The transport module.

+
+
Socket
+

The socket.

+
+
File
+

The filename or file descriptor for the file to be sent.

+
+
Offset
+

Start position in the file, in bytes.

+
+
Bytes
+

Length in bytes.

+
+
Opts
+

Additional options.

+
+
+

Return value

+

The number of bytes actually sent is returned on success inside an ok tuple.

+

An error tuple is returned otherwise.

+

Changelog

+
  • 1.6: The type of the File argument was extended. +
    • +
+

Examples

+
Implement Transport:sendfile using the fallback
+
+
sendfile(Socket, Filename) ->
+    sendfile(Socket, Filename, 0, 0, []).
+
+sendfile(Socket, File, Offset, Bytes) ->
+    sendfile(Socket, File, Offset, Bytes, []).
+
+sendfile(Socket, File, Offset, Bytes, Opts) ->
+    ranch_transport:sendfile(?MODULE, Socket,
+        File, Offset, Bytes, Opts).
+
+

See also

+

ranch_transport(3)

+ + + + + + +
+ +
+ + +

+ Ranch + 1.7 + Function Reference + +

+ + + +

Navigation

+ +

Version select

+ + +
+
+
+
+ + + + + + + + + -- cgit v1.2.3