diff options
Diffstat (limited to 'templates/man3/getprotoent_r.3.pot')
| -rw-r--r-- | templates/man3/getprotoent_r.3.pot | 644 |
1 files changed, 644 insertions, 0 deletions
diff --git a/templates/man3/getprotoent_r.3.pot b/templates/man3/getprotoent_r.3.pot new file mode 100644 index 00000000..aaa2e9e9 --- /dev/null +++ b/templates/man3/getprotoent_r.3.pot @@ -0,0 +1,644 @@ +# 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:57+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 "getprotoent_r" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "2023-10-31" +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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"getprotoent_r, getprotobyname_r, getprotobynumber_r - get protocol entry " +"(reentrant)" +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-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<#include E<lt>netdb.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<int getprotoent_r(struct protoent *restrict >I<result_buf>B<,>\n" +"B< char >I<buf>B<[restrict .>I<buflen>B<], size_t >I<buflen>B<,>\n" +"B< struct protoent **restrict >I<result>B<);>\n" +"B<int getprotobyname_r(const char *restrict >I<name>B<,>\n" +"B< struct protoent *restrict >I<result_buf>B<,>\n" +"B< char >I<buf>B<[restrict .>I<buflen>B<], size_t >I<buflen>B<,>\n" +"B< struct protoent **restrict >I<result>B<);>\n" +"B<int getprotobynumber_r(int >I<proto>B<,>\n" +"B< struct protoent *restrict >I<result_buf>B<,>\n" +"B< char >I<buf>B<[restrict .>I<buflen>B<], size_t >I<buflen>B<,>\n" +"B< struct protoent **restrict >I<result>B<);>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "B<getprotoent_r>(), B<getprotobyname_r>(), B<getprotobynumber_r>():" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +" Since glibc 2.19:\n" +" _DEFAULT_SOURCE\n" +" glibc 2.19 and earlier:\n" +" _BSD_SOURCE || _SVID_SOURCE\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<getprotoent_r>(), B<getprotobyname_r>(), and B<getprotobynumber_r>() " +"functions are the reentrant equivalents of, respectively, B<getprotoent>(3), " +"B<getprotobyname>(3), and B<getprotobynumber>(3). They differ in the way " +"that the I<protoent> structure is returned, and in the function calling " +"signature and return value. This manual page describes just the differences " +"from the nonreentrant functions." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Instead of returning a pointer to a statically allocated I<protoent> " +"structure as the function result, these functions copy the structure into " +"the location pointed to by I<result_buf>." +msgstr "" + +#. I can find no information on the required/recommended buffer size; +#. the nonreentrant functions use a 1024 byte buffer. +#. The 1024 byte value is also what the Solaris man page suggests. -- mtk +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<buf> array is used to store the string fields pointed to by the " +"returned I<protoent> structure. (The nonreentrant functions allocate these " +"strings in static storage.) The size of this array is specified in " +"I<buflen>. If I<buf> is too small, the call fails with the error B<ERANGE>, " +"and the caller must try again with a larger buffer. (A buffer of length " +"1024 bytes should be sufficient for most applications.)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If the function call successfully obtains a protocol record, then I<*result> " +"is set pointing to I<result_buf>; otherwise, I<*result> is set to NULL." +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 "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"On success, these functions return 0. On error, they return one of the " +"positive error numbers listed in ERRORS." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"On error, record not found (B<getprotobyname_r>(), B<getprotobynumber_r>()), " +"or end of input (B<getprotoent_r>()) I<result> is set to NULL." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "ERRORS" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ENOENT>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "(B<getprotoent_r>()) No more records in database." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ERANGE>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<buf> is too small. Try again with a larger buffer (and increased " +"I<buflen>)." +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<getprotoent_r>(),\n" +"B<getprotobyname_r>(),\n" +"B<getprotobynumber_r>()" +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 locale" +msgstr "" + +#. type: SH +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "VERSIONS" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Functions with similar names exist on some other systems, though typically " +"with different calling signatures." +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 uses B<getprotobyname_r>() to retrieve the protocol " +"record for the protocol named in its first command-line argument. If a " +"second (integer) command-line argument is supplied, it is used as the " +"initial value for I<buflen>; if B<getprotobyname_r>() fails with the error " +"B<ERANGE>, the program retries with larger buffer sizes. The following " +"shell session shows a couple of sample runs:" +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 tcp 1>\n" +"ERANGE! Retrying with larger buffer\n" +"getprotobyname_r() returned: 0 (success) (buflen=78)\n" +"p_name=tcp; p_proto=6; aliases=TCP\n" +"$B< ./a.out xxx 1>\n" +"ERANGE! Retrying with larger buffer\n" +"getprotobyname_r() returned: 0 (success) (buflen=100)\n" +"Call failed/record not found\n" +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>ctype.hE<gt>\n" +"#include E<lt>errno.hE<gt>\n" +"#include E<lt>netdb.hE<gt>\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>string.hE<gt>\n" +"\\&\n" +"#define MAX_BUF 10000\n" +"\\&\n" +"int\n" +"main(int argc, char *argv[])\n" +"{\n" +" int buflen, erange_cnt, s;\n" +" struct protoent result_buf;\n" +" struct protoent *result;\n" +" char buf[MAX_BUF];\n" +"\\&\n" +" if (argc E<lt> 2) {\n" +" printf(\"Usage: %s proto-name [buflen]\\en\", argv[0]);\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" buflen = 1024;\n" +" if (argc E<gt> 2)\n" +" buflen = atoi(argv[2]);\n" +"\\&\n" +" if (buflen E<gt> MAX_BUF) {\n" +" printf(\"Exceeded buffer limit (%d)\\en\", MAX_BUF);\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" erange_cnt = 0;\n" +" do {\n" +" s = getprotobyname_r(argv[1], &result_buf,\n" +" buf, buflen, &result);\n" +" if (s == ERANGE) {\n" +" if (erange_cnt == 0)\n" +" printf(\"ERANGE! Retrying with larger buffer\\en\");\n" +" erange_cnt++;\n" +"\\&\n" +" /* Increment a byte at a time so we can see exactly\n" +" what size buffer was required. */\n" +"\\&\n" +" buflen++;\n" +"\\&\n" +" if (buflen E<gt> MAX_BUF) {\n" +" printf(\"Exceeded buffer limit (%d)\\en\", MAX_BUF);\n" +" exit(EXIT_FAILURE);\n" +" }\n" +" }\n" +" } while (s == ERANGE);\n" +"\\&\n" +" printf(\"getprotobyname_r() returned: %s (buflen=%d)\\en\",\n" +" (s == 0) ? \"0 (success)\" : (s == ENOENT) ? \"ENOENT\" :\n" +" strerror(s), buflen);\n" +"\\&\n" +" if (s != 0 || result == NULL) {\n" +" printf(\"Call failed/record not found\\en\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" printf(\"p_name=%s; p_proto=%d; aliases=\",\n" +" result_buf.p_name, result_buf.p_proto);\n" +" for (char **p = result_buf.p_aliases; *p != NULL; p++)\n" +" printf(\"%s \", *p);\n" +" printf(\"\\en\");\n" +"\\&\n" +" exit(EXIT_SUCCESS);\n" +"}\n" +msgstr "" + +#. SRC END +#. 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<getprotoent>(3), B<protocols>(5)" +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 +msgid "" +"These functions are GNU extensions. Functions with similar names exist on " +"some other systems, though typically with different calling signatures." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"#define _GNU_SOURCE\n" +"#include E<lt>ctype.hE<gt>\n" +"#include E<lt>errno.hE<gt>\n" +"#include E<lt>netdb.hE<gt>\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>string.hE<gt>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "#define MAX_BUF 10000\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"int\n" +"main(int argc, char *argv[])\n" +"{\n" +" int buflen, erange_cnt, s;\n" +" struct protoent result_buf;\n" +" struct protoent *result;\n" +" char buf[MAX_BUF];\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" if (argc E<lt> 2) {\n" +" printf(\"Usage: %s proto-name [buflen]\\en\", argv[0]);\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" buflen = 1024;\n" +" if (argc E<gt> 2)\n" +" buflen = atoi(argv[2]);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" if (buflen E<gt> MAX_BUF) {\n" +" printf(\"Exceeded buffer limit (%d)\\en\", MAX_BUF);\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" erange_cnt = 0;\n" +" do {\n" +" s = getprotobyname_r(argv[1], &result_buf,\n" +" buf, buflen, &result);\n" +" if (s == ERANGE) {\n" +" if (erange_cnt == 0)\n" +" printf(\"ERANGE! Retrying with larger buffer\\en\");\n" +" erange_cnt++;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" /* Increment a byte at a time so we can see exactly\n" +" what size buffer was required. */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " buflen++;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" if (buflen E<gt> MAX_BUF) {\n" +" printf(\"Exceeded buffer limit (%d)\\en\", MAX_BUF);\n" +" exit(EXIT_FAILURE);\n" +" }\n" +" }\n" +" } while (s == ERANGE);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" printf(\"getprotobyname_r() returned: %s (buflen=%d)\\en\",\n" +" (s == 0) ? \"0 (success)\" : (s == ENOENT) ? \"ENOENT\" :\n" +" strerror(s), buflen);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" if (s != 0 || result == NULL) {\n" +" printf(\"Call failed/record not found\\en\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" printf(\"p_name=%s; p_proto=%d; aliases=\",\n" +" result_buf.p_name, result_buf.p_proto);\n" +" for (char **p = result_buf.p_aliases; *p != NULL; p++)\n" +" printf(\"%s \", *p);\n" +" printf(\"\\en\");\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 "" |