aboutsummaryrefslogtreecommitdiff
path: root/devel/py-sendfile
diff options
context:
space:
mode:
authorPav Lucistnik <pav@FreeBSD.org>2005-02-06 22:45:24 +0000
committerPav Lucistnik <pav@FreeBSD.org>2005-02-06 22:45:24 +0000
commit0023c7ee78815208ad62cc585ad1cd59498515d7 (patch)
tree9a159e667f6a8acd754612a581f90c1904ccd389 /devel/py-sendfile
parent5562eae1ed1dca98b957d6a380ea8e5c177a3b08 (diff)
downloadports-0023c7ee78815208ad62cc585ad1cd59498515d7.tar.gz
ports-0023c7ee78815208ad62cc585ad1cd59498515d7.zip
Notes
Diffstat (limited to 'devel/py-sendfile')
-rw-r--r--devel/py-sendfile/Makefile2
-rw-r--r--devel/py-sendfile/distinfo4
-rw-r--r--devel/py-sendfile/files/patch-sendfilemodule.c77
3 files changed, 80 insertions, 3 deletions
diff --git a/devel/py-sendfile/Makefile b/devel/py-sendfile/Makefile
index 9105dccc8e08..aa2936ecb20c 100644
--- a/devel/py-sendfile/Makefile
+++ b/devel/py-sendfile/Makefile
@@ -6,7 +6,7 @@
#
PORTNAME= sendfile
-PORTVERSION= 1.1
+PORTVERSION= 1.2
CATEGORIES= devel python
MASTER_SITES= http://tautology.org/software/python-modules/distfiles/
PKGNAMEPREFIX= ${PYTHON_PKGNAMEPREFIX}
diff --git a/devel/py-sendfile/distinfo b/devel/py-sendfile/distinfo
index d3ce196783c9..de3503971172 100644
--- a/devel/py-sendfile/distinfo
+++ b/devel/py-sendfile/distinfo
@@ -1,2 +1,2 @@
-MD5 (py-sendfile-1.1.tar.bz2) = d1ae993f9af8666bbb19ae2596d78b37
-SIZE (py-sendfile-1.1.tar.bz2) = 2977
+MD5 (py-sendfile-1.2.tar.bz2) = be1b00596f73951a453858a406803817
+SIZE (py-sendfile-1.2.tar.bz2) = 3825
diff --git a/devel/py-sendfile/files/patch-sendfilemodule.c b/devel/py-sendfile/files/patch-sendfilemodule.c
new file mode 100644
index 000000000000..3687c6728bb3
--- /dev/null
+++ b/devel/py-sendfile/files/patch-sendfilemodule.c
@@ -0,0 +1,77 @@
+--- sendfilemodule.c.orig Sun Feb 6 13:17:43 2005
++++ sendfilemodule.c Sun Feb 6 23:41:08 2005
+@@ -174,40 +174,40 @@
+
+ static PyMethodDef SendfileMethods[] = {
+ {"sendfile", method_sendfile, METH_VARARGS,
+-"sendfile(out_fd, in_fd, offset, count) = [position, sent]
+-
+-FreeBSD only:
+-sendfile(out_fd, in_fd, offset, count, headers_and_or_trailers) = [position, sent]
+-
+-Direct interface to FreeBSD and Linux sendfile(2) using the Linux API, except that errors are turned into Python exceptions, and instead of returning only the amount of data being sent, it returns a tuple that contains the new file pointer, and the amount of data that has been sent.
+-
+-For example:
+-
+-from sendfile import *
+-sendfile(out_socket.fileno(), in_file.fileno(), int_start, int_len)
+-
+-On Linux, item 0 of the return value is always a reliable file pointer. The value specified in the offset argument is handed to the syscall, which then updates it according to how much data has been sent. The length of data sent is returned in item 1 of the return value.
+-
+-FreeBSD sf_hdtr is also supported as an additional argument which can be a string, list, or tuple. If it is a string, it will create a struct iovec of length 1 containing the string which will be sent as the header. If a list, it will create a struct iovec of the length of the list, containing the strings in the list, which will be concatenated by the syscall to form the total header. If a tuple, it will expect a string or list of strings in two items: the first representing the header, and the second representing the trailer, processed the same way as the header. You can send only a footer by making the header an empty string or list, or list of empty strings.
+-
+-FreeBSD example with string header:
+-
+-from sendfile import *
+-sendfile(out_socket.fileno(), in_file.fileno(), 0, 0, \"HTTP/1.1 200 OK\\r\\nContent-Type: text/html\\r\\nConnection: close\\r\\n\\r\\n\")
+-
+-FreeBSD example with both header and trailer as a string:
+-
+-from sendfile import *
+-sendfile(out_socket.fileno(), in_file.fileno(), int_start, int_len, ('BEGIN', 'END'))
+-
+-FreeBSD example with mixed types:
+-
+-from sendfile import *
+-sendfile(out_socket.fileno(), in_file.fileno(), int_start, int_len, ([magic, metadata_len, metadata, data_len], md5))
+-
+-Although the FreeBSD sendfile(2) requires the socket file descriptor to be specified as the second argument, this function will ALWAYS require the socket as the first argument, like Linux and Solaris. Also, if an sf_hdtr is specified, the function will return the total data sent including all of the headers and trailers. Note that item 0 of the return value, the file pointer position, is determined on FreeBSD only by adding offset and count, so if not all of the data has been sent, this value will be wrong. You will have to use the value in item 1, which tells you how much total data has actually been sent, and be aware that header and trailer data are included in that value, so you may need to reconstruct the headers and/or trailers yourself if you would like to find out exactly which data has been sent. However, if you do not send any headers or trailers, you can just add item 1 to where you started to find out where you need to start from again. I do not consider this much of a problem because if you are sending header and trailer data, the protocol will likely not allow you to just keep sending from where the failure occured without getting into complexities, anyway.
+-
+-The variable has_sf_hdtr is provided for determining whether sf_hdtr is supported."},
++"sendfile(out_fd, in_fd, offset, count) = [position, sent]"
++""
++"FreeBSD only:"
++"sendfile(out_fd, in_fd, offset, count, headers_and_or_trailers) = [position, sent]"
++""
++"Direct interface to FreeBSD and Linux sendfile(2) using the Linux API, except that errors are turned into Python exceptions, and instead of returning only the amount of data being sent, it returns a tuple that contains the new file pointer, and the amount of data that has been sent. "
++""
++"For example:"
++""
++"from sendfile import *"
++"sendfile(out_socket.fileno(), in_file.fileno(), int_start, int_len)"
++""
++"On Linux, item 0 of the return value is always a reliable file pointer. The value specified in the offset argument is handed to the syscall, which then updates it according to how much data has been sent. The length of data sent is returned in item 1 of the return value."
++""
++"FreeBSD sf_hdtr is also supported as an additional argument which can be a string, list, or tuple. If it is a string, it will create a struct iovec of length 1 containing the string which will be sent as the header. If a list, it will create a struct iovec of the length of the list, containing the strings in the list, which will be concatenated by the syscall to form the total header. If a tuple, it will expect a string or list of strings in two items: the first representing the header, and the second representing the trailer, processed the same way as the header. You can send only a footer by making the header an empty string or list, or list of empty strings."
++""
++"FreeBSD example with string header:"
++""
++"from sendfile import *"
++"sendfile(out_socket.fileno(), in_file.fileno(), 0, 0, \"HTTP/1.1 200 OK\\r\\nContent-Type: text/html\\r\\nConnection: close\\r\\n\\r\\n\")"
++""
++"FreeBSD example with both header and trailer as a string:"
++""
++"from sendfile import *"
++"sendfile(out_socket.fileno(), in_file.fileno(), int_start, int_len, ('BEGIN', 'END'))"
++""
++"FreeBSD example with mixed types:"
++""
++"from sendfile import *"
++"sendfile(out_socket.fileno(), in_file.fileno(), int_start, int_len, ([magic, metadata_len, metadata, data_len], md5))"
++""
++"Although the FreeBSD sendfile(2) requires the socket file descriptor to be specified as the second argument, this function will ALWAYS require the socket as the first argument, like Linux and Solaris. Also, if an sf_hdtr is specified, the function will return the total data sent including all of the headers and trailers. Note that item 0 of the return value, the file pointer position, is determined on FreeBSD only by adding offset and count, so if not all of the data has been sent, this value will be wrong. You will have to use the value in item 1, which tells you how much total data has actually been sent, and be aware that header and trailer data are included in that value, so you may need to reconstruct the headers and/or trailers yourself if you would like to find out exactly which data has been sent. However, if you do not send any headers or trailers, you can just add item 1 to where you started to find out where you need to start from again. I do not consider this much of a problem because if you are sending header and trailer data, the protocol will likely not allow you to just keep sending from where the failure occured without getting into complexities, anyway. "
++""
++"The variable has_sf_hdtr is provided for determining whether sf_hdtr is supported."},
+ {NULL, NULL, 0, NULL} /* Sentinel */
+ };
+