diff options
Diffstat (limited to 'templates/man3/fopencookie.3.pot')
| -rw-r--r-- | templates/man3/fopencookie.3.pot | 1165 |
1 files changed, 1165 insertions, 0 deletions
diff --git a/templates/man3/fopencookie.3.pot b/templates/man3/fopencookie.3.pot new file mode 100644 index 00000000..b8d787c5 --- /dev/null +++ b/templates/man3/fopencookie.3.pot @@ -0,0 +1,1165 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2024-03-01 16:56+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: TH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "fopencookie" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "2023-12-29" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "Linux man-pages 6.06" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +msgid "fopencookie - open a custom stream" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "LIBRARY" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Standard C library (I<libc>, I<-lc>)" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"B<#define _GNU_SOURCE> /* See feature_test_macros(7) */\n" +"B<#define _FILE_OFFSET_BITS 64>\n" +"B<#include E<lt>stdio.hE<gt>>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"B<FILE *fopencookie(void *restrict >I<cookie>B<, const char *restrict >I<mode>B<,>\n" +"B< cookie_io_functions_t >I<io_funcs>B<);>\n" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<fopencookie>() function allows the programmer to create a custom " +"implementation for a standard I/O stream. This implementation can store the " +"stream's data at a location of its own choosing; for example, " +"B<fopencookie>() is used to implement B<fmemopen>(3), which provides a " +"stream interface to data that is stored in a buffer in memory." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "In order to create a custom stream the programmer must:" +msgstr "" + +#. type: IP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "\\[bu]" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Implement four \"hook\" functions that are used internally by the standard I/" +"O library when performing I/O on the stream." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Define a \"cookie\" data type, a structure that provides bookkeeping " +"information (e.g., where to store data) used by the aforementioned hook " +"functions. The standard I/O package knows nothing about the contents of " +"this cookie (thus it is typed as I<void\\~*> when passed to " +"B<fopencookie>()), but automatically supplies the cookie as the first " +"argument when calling the hook functions." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Call B<fopencookie>() to open a new stream and associate the cookie and " +"hook functions with that stream." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<fopencookie>() function serves a purpose similar to B<fopen>(3): it " +"opens a new stream and returns a pointer to a I<FILE> object that is used to " +"operate on that stream." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<cookie> argument is a pointer to the caller's cookie structure that is " +"to be associated with the new stream. This pointer is supplied as the first " +"argument when the standard I/O library invokes any of the hook functions " +"described below." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<mode> argument serves the same purpose as for B<fopen>(3). The " +"following modes are supported: I<r>, I<w>, I<a>, I<r+>, I<w+>, and I<a+>. " +"See B<fopen>(3) for details." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<io_funcs> argument is a structure that contains four fields pointing " +"to the programmer-defined hook functions that are used to implement this " +"stream. The structure is defined as follows" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"typedef struct {\n" +" cookie_read_function_t *read;\n" +" cookie_write_function_t *write;\n" +" cookie_seek_function_t *seek;\n" +" cookie_close_function_t *close;\n" +"} cookie_io_functions_t;\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "The four fields are as follows:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "I<cookie_read_function_t *read>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This function implements read operations for the stream. When called, it " +"receives three arguments:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "ssize_t read(void *cookie, char *buf, size_t size);\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<buf> and I<size> arguments are, respectively, a buffer into which " +"input data can be placed and the size of that buffer. As its function " +"result, the I<read> function should return the number of bytes copied into " +"I<buf>, 0 on end of file, or -1 on error. The I<read> function should " +"update the stream offset appropriately." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<*read> is a null pointer, then reads from the custom stream always " +"return end of file." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "I<cookie_write_function_t *write>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This function implements write operations for the stream. When called, it " +"receives three arguments:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "ssize_t write(void *cookie, const char *buf, size_t size);\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<buf> and I<size> arguments are, respectively, a buffer of data to be " +"output to the stream and the size of that buffer. As its function result, " +"the I<write> function should return the number of bytes copied from I<buf>, " +"or 0 on error. (The function must not return a negative value.) The " +"I<write> function should update the stream offset appropriately." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "If I<*write> is a null pointer, then output to the stream is discarded." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "I<cookie_seek_function_t *seek>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This function implements seek operations on the stream. When called, it " +"receives three arguments:" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "int seek(void *cookie, off_t *offset, int whence);\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<*offset> argument specifies the new file offset depending on which of " +"the following three values is supplied in I<whence>:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<SEEK_SET>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The stream offset should be set I<*offset> bytes from the start of the " +"stream." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<SEEK_CUR>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<*offset> should be added to the current stream offset." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<SEEK_END>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The stream offset should be set to the size of the stream plus I<*offset>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Before returning, the I<seek> function should update I<*offset> to indicate " +"the new stream offset." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"As its function result, the I<seek> function should return 0 on success, and " +"-1 on error." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<*seek> is a null pointer, then it is not possible to perform seek " +"operations on the stream." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "I<cookie_close_function_t *close>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This function closes the stream. The hook function can do things such as " +"freeing buffers allocated for the stream. When called, it receives one " +"argument:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "int close(void *cookie);\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<cookie> argument is the cookie that the programmer supplied when " +"calling B<fopencookie>()." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"As its function result, the I<close> function should return 0 on success, " +"and B<EOF> on error." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<*close> is NULL, then no special action is performed when the stream is " +"closed." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "RETURN VALUE" +msgstr "" + +#. .SH ERRORS +#. It's not clear if errno ever gets set... +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"On success B<fopencookie>() returns a pointer to the new stream. On error, " +"NULL is returned." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "ATTRIBUTES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"For an explanation of the terms used in this section, see B<attributes>(7)." +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Interface" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Attribute" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Value" +msgstr "" + +#. type: tbl table +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid ".na\n" +msgstr "" + +#. type: tbl table +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid ".nh\n" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<fopencookie>()" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Thread safety" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "MT-Safe" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "STANDARDS" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "GNU." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "EXAMPLES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The program below implements a custom stream whose functionality is similar " +"(but not identical) to that available via B<fmemopen>(3). It implements a " +"stream whose data is stored in a memory buffer. The program writes its " +"command-line arguments to the stream, and then seeks through the stream " +"reading two out of every five characters and writing them to standard " +"output. The following shell session demonstrates the use of the program:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"$B< ./a.out \\[aq]hello world\\[aq]>\n" +"/he/\n" +"/ w/\n" +"/d/\n" +"Reached end of file\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Note that a more general version of the program below could be improved to " +"more robustly handle various error situations (e.g., opening a stream with a " +"cookie that already has an open stream; closing a stream that has already " +"been closed)." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Program source" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"#define _GNU_SOURCE\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>string.hE<gt>\n" +"#include E<lt>sys/types.hE<gt>\n" +"#include E<lt>unistd.hE<gt>\n" +"\\&\n" +"#define INIT_BUF_SIZE 4\n" +"\\&\n" +"struct memfile_cookie {\n" +" char *buf; /* Dynamically sized buffer for data */\n" +" size_t allocated; /* Size of buf */\n" +" size_t endpos; /* Number of characters in buf */\n" +" off_t offset; /* Current file offset in buf */\n" +"};\n" +"\\&\n" +"ssize_t\n" +"memfile_write(void *c, const char *buf, size_t size)\n" +"{\n" +" char *new_buff;\n" +" struct memfile_cookie *cookie = c;\n" +"\\&\n" +" /* Buffer too small? Keep doubling size until big enough. */\n" +"\\&\n" +" while (size + cookie-E<gt>offset E<gt> cookie-E<gt>allocated) {\n" +" new_buff = realloc(cookie-E<gt>buf, cookie-E<gt>allocated * 2);\n" +" if (new_buff == NULL)\n" +" return -1;\n" +" cookie-E<gt>allocated *= 2;\n" +" cookie-E<gt>buf = new_buff;\n" +" }\n" +"\\&\n" +" memcpy(cookie-E<gt>buf + cookie-E<gt>offset, buf, size);\n" +"\\&\n" +" cookie-E<gt>offset += size;\n" +" if (cookie-E<gt>offset E<gt> cookie-E<gt>endpos)\n" +" cookie-E<gt>endpos = cookie-E<gt>offset;\n" +"\\&\n" +" return size;\n" +"}\n" +"\\&\n" +"ssize_t\n" +"memfile_read(void *c, char *buf, size_t size)\n" +"{\n" +" ssize_t xbytes;\n" +" struct memfile_cookie *cookie = c;\n" +"\\&\n" +" /* Fetch minimum of bytes requested and bytes available. */\n" +"\\&\n" +" xbytes = size;\n" +" if (cookie-E<gt>offset + size E<gt> cookie-E<gt>endpos)\n" +" xbytes = cookie-E<gt>endpos - cookie-E<gt>offset;\n" +" if (xbytes E<lt> 0) /* offset may be past endpos */\n" +" xbytes = 0;\n" +"\\&\n" +" memcpy(buf, cookie-E<gt>buf + cookie-E<gt>offset, xbytes);\n" +"\\&\n" +" cookie-E<gt>offset += xbytes;\n" +" return xbytes;\n" +"}\n" +"\\&\n" +"int\n" +"memfile_seek(void *c, off_t *offset, int whence)\n" +"{\n" +" off_t new_offset;\n" +" struct memfile_cookie *cookie = c;\n" +"\\&\n" +" if (whence == SEEK_SET)\n" +" new_offset = *offset;\n" +" else if (whence == SEEK_END)\n" +" new_offset = cookie-E<gt>endpos + *offset;\n" +" else if (whence == SEEK_CUR)\n" +" new_offset = cookie-E<gt>offset + *offset;\n" +" else\n" +" return -1;\n" +"\\&\n" +" if (new_offset E<lt> 0)\n" +" return -1;\n" +"\\&\n" +" cookie-E<gt>offset = new_offset;\n" +" *offset = new_offset;\n" +" return 0;\n" +"}\n" +"\\&\n" +"int\n" +"memfile_close(void *c)\n" +"{\n" +" struct memfile_cookie *cookie = c;\n" +"\\&\n" +" free(cookie-E<gt>buf);\n" +" cookie-E<gt>allocated = 0;\n" +" cookie-E<gt>buf = NULL;\n" +"\\&\n" +" return 0;\n" +"}\n" +"\\&\n" +"int\n" +"main(int argc, char *argv[])\n" +"{\n" +" cookie_io_functions_t memfile_func = {\n" +" .read = memfile_read,\n" +" .write = memfile_write,\n" +" .seek = memfile_seek,\n" +" .close = memfile_close\n" +" };\n" +" FILE *stream;\n" +" struct memfile_cookie mycookie;\n" +" size_t nread;\n" +" char buf[1000];\n" +"\\&\n" +" /* Set up the cookie before calling fopencookie(). */\n" +"\\&\n" +" mycookie.buf = malloc(INIT_BUF_SIZE);\n" +" if (mycookie.buf == NULL) {\n" +" perror(\"malloc\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" mycookie.allocated = INIT_BUF_SIZE;\n" +" mycookie.offset = 0;\n" +" mycookie.endpos = 0;\n" +"\\&\n" +" stream = fopencookie(&mycookie, \"w+\", memfile_func);\n" +" if (stream == NULL) {\n" +" perror(\"fopencookie\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" /* Write command-line arguments to our file. */\n" +"\\&\n" +" for (size_t j = 1; j E<lt> argc; j++)\n" +" if (fputs(argv[j], stream) == EOF) {\n" +" perror(\"fputs\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" /* Read two bytes out of every five, until EOF. */\n" +"\\&\n" +" for (long p = 0; ; p += 5) {\n" +" if (fseek(stream, p, SEEK_SET) == -1) {\n" +" perror(\"fseek\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +" nread = fread(buf, 1, 2, stream);\n" +" if (nread == 0) {\n" +" if (ferror(stream) != 0) {\n" +" fprintf(stderr, \"fread failed\\en\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +" printf(\"Reached end of file\\en\");\n" +" break;\n" +" }\n" +"\\&\n" +" printf(\"/%.*s/\\en\", (int) nread, buf);\n" +" }\n" +"\\&\n" +" free(mycookie.buf);\n" +"\\&\n" +" exit(EXIT_SUCCESS);\n" +"}\n" +msgstr "" + +#. SRC END +#. type: SH +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +msgid "" +"B<_FILE_OFFSET_BITS> should be defined to be 64 in code that uses non-null " +"I<seek> or that takes the address of B<fopencookie>, if the code is intended " +"to be portable to traditional 32-bit x86 and ARM platforms where B<off_t>'s " +"width defaults to 32 bits." +msgstr "" + +#. #-#-#-#-# archlinux: fopencookie.3.pot (PACKAGE VERSION) #-#-#-#-# +#. type: SH +#. #-#-#-#-# debian-bookworm: fopencookie.3.pot (PACKAGE VERSION) #-#-#-#-# +#. SRC END +#. type: SH +#. #-#-#-#-# debian-unstable: fopencookie.3.pot (PACKAGE VERSION) #-#-#-#-# +#. type: SH +#. #-#-#-#-# fedora-40: fopencookie.3.pot (PACKAGE VERSION) #-#-#-#-# +#. type: SH +#. #-#-#-#-# fedora-rawhide: fopencookie.3.pot (PACKAGE VERSION) #-#-#-#-# +#. type: SH +#. #-#-#-#-# mageia-cauldron: fopencookie.3.pot (PACKAGE VERSION) #-#-#-#-# +#. type: SH +#. #-#-#-#-# opensuse-leap-15-6: fopencookie.3.pot (PACKAGE VERSION) #-#-#-#-# +#. SRC END +#. type: SH +#. #-#-#-#-# opensuse-tumbleweed: fopencookie.3.pot (PACKAGE VERSION) #-#-#-#-# +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "B<fclose>(3), B<fmemopen>(3), B<fopen>(3), B<fseek>(3)" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "2023-02-05" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "Linux man-pages 6.03" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +msgid "fopencookie - opening a custom stream" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"B<#define _GNU_SOURCE> /* See feature_test_macros(7) */\n" +"B<#include E<lt>stdio.hE<gt>>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "int seek(void *cookie, off64_t *offset, int whence);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "This function is a nonstandard GNU extension." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"#define _GNU_SOURCE\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>string.hE<gt>\n" +"#include E<lt>sys/types.hE<gt>\n" +"#include E<lt>unistd.hE<gt>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "#define INIT_BUF_SIZE 4\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"struct memfile_cookie {\n" +" char *buf; /* Dynamically sized buffer for data */\n" +" size_t allocated; /* Size of buf */\n" +" size_t endpos; /* Number of characters in buf */\n" +" off_t offset; /* Current file offset in buf */\n" +"};\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"ssize_t\n" +"memfile_write(void *c, const char *buf, size_t size)\n" +"{\n" +" char *new_buff;\n" +" struct memfile_cookie *cookie = c;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " /* Buffer too small? Keep doubling size until big enough. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" while (size + cookie-E<gt>offset E<gt> cookie-E<gt>allocated) {\n" +" new_buff = realloc(cookie-E<gt>buf, cookie-E<gt>allocated * 2);\n" +" if (new_buff == NULL)\n" +" return -1;\n" +" cookie-E<gt>allocated *= 2;\n" +" cookie-E<gt>buf = new_buff;\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " memcpy(cookie-E<gt>buf + cookie-E<gt>offset, buf, size);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" cookie-E<gt>offset += size;\n" +" if (cookie-E<gt>offset E<gt> cookie-E<gt>endpos)\n" +" cookie-E<gt>endpos = cookie-E<gt>offset;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" return size;\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"ssize_t\n" +"memfile_read(void *c, char *buf, size_t size)\n" +"{\n" +" ssize_t xbytes;\n" +" struct memfile_cookie *cookie = c;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " /* Fetch minimum of bytes requested and bytes available. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" xbytes = size;\n" +" if (cookie-E<gt>offset + size E<gt> cookie-E<gt>endpos)\n" +" xbytes = cookie-E<gt>endpos - cookie-E<gt>offset;\n" +" if (xbytes E<lt> 0) /* offset may be past endpos */\n" +" xbytes = 0;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " memcpy(buf, cookie-E<gt>buf + cookie-E<gt>offset, xbytes);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" cookie-E<gt>offset += xbytes;\n" +" return xbytes;\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"int\n" +"memfile_seek(void *c, off64_t *offset, int whence)\n" +"{\n" +" off64_t new_offset;\n" +" struct memfile_cookie *cookie = c;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" if (whence == SEEK_SET)\n" +" new_offset = *offset;\n" +" else if (whence == SEEK_END)\n" +" new_offset = cookie-E<gt>endpos + *offset;\n" +" else if (whence == SEEK_CUR)\n" +" new_offset = cookie-E<gt>offset + *offset;\n" +" else\n" +" return -1;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" if (new_offset E<lt> 0)\n" +" return -1;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" cookie-E<gt>offset = new_offset;\n" +" *offset = new_offset;\n" +" return 0;\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"int\n" +"memfile_close(void *c)\n" +"{\n" +" struct memfile_cookie *cookie = c;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" free(cookie-E<gt>buf);\n" +" cookie-E<gt>allocated = 0;\n" +" cookie-E<gt>buf = NULL;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" return 0;\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"int\n" +"main(int argc, char *argv[])\n" +"{\n" +" cookie_io_functions_t memfile_func = {\n" +" .read = memfile_read,\n" +" .write = memfile_write,\n" +" .seek = memfile_seek,\n" +" .close = memfile_close\n" +" };\n" +" FILE *stream;\n" +" struct memfile_cookie mycookie;\n" +" size_t nread;\n" +" char buf[1000];\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " /* Set up the cookie before calling fopencookie(). */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" mycookie.buf = malloc(INIT_BUF_SIZE);\n" +" if (mycookie.buf == NULL) {\n" +" perror(\"malloc\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" mycookie.allocated = INIT_BUF_SIZE;\n" +" mycookie.offset = 0;\n" +" mycookie.endpos = 0;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" stream = fopencookie(&mycookie, \"w+\", memfile_func);\n" +" if (stream == NULL) {\n" +" perror(\"fopencookie\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " /* Write command-line arguments to our file. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" for (size_t j = 1; j E<lt> argc; j++)\n" +" if (fputs(argv[j], stream) == EOF) {\n" +" perror(\"fputs\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " /* Read two bytes out of every five, until EOF. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" for (long p = 0; ; p += 5) {\n" +" if (fseek(stream, p, SEEK_SET) == -1) {\n" +" perror(\"fseek\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +" nread = fread(buf, 1, 2, stream);\n" +" if (nread == 0) {\n" +" if (ferror(stream) != 0) {\n" +" fprintf(stderr, \"fread failed\\en\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +" printf(\"Reached end of file\\en\");\n" +" break;\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" printf(\"/%.*s/\\en\", (int) nread, buf);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " free(mycookie.buf);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" exit(EXIT_SUCCESS);\n" +"}\n" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "2023-07-20" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages 6.05.01" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "2023-03-30" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "Linux man-pages 6.04" +msgstr "" |