# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2024-06-01 05:53+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "getspnam" 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: SH #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "getspnam, getspnam_r, getspent, getspent_r, setspent, endspent, fgetspent, " "fgetspent_r, sgetspent, sgetspent_r, putspent, lckpwdf, ulckpwdf - get " "shadow password file entry" msgstr "" #. type: SH #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "LIBRARY" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "Standard C library (I, I<-lc>)" msgstr "" #. type: SH #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "/* General shadow password file API */\n" "B<#include Eshadow.hE>\n" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "BIB<);>\n" "B\n" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "B\n" "B\n" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "BIB<);>\n" "BIB<);>\n" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "BI

B<, FILE *>IB<);>\n" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "B\n" "B\n" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "/* GNU extension */\n" "B<#include Eshadow.hE>\n" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "BIB<,>\n" "B< char >IB<[.>IB<], size_t >IB<, struct spwd **>IB<);>\n" "BIB<, struct spwd *>IB<,>\n" "B< char >IB<[.>IB<], size_t >IB<, struct spwd **>IB<);>\n" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "BIB<, struct spwd *>IB<,>\n" "B< char >IB<[.>IB<], size_t >IB<, struct spwd **>IB<);>\n" "BIB<, struct spwd *>IB<,>\n" "B< char >IB<[.>IB<], size_t >IB<, struct spwd **>IB<);>\n" msgstr "" #. type: Plain text #: 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(7)):" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "B(), B(), B(), B():" msgstr "" #. type: Plain text #: 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 #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Long ago it was considered safe to have encrypted passwords openly visible " "in the password file. When computers got faster and people got more " "security-conscious, this was no longer acceptable. Julianne Frances Haugh " "implemented the shadow password suite that keeps the encrypted passwords in " "the shadow password database (e.g., the local shadow password file I, NIS, and LDAP), readable only by root." msgstr "" # #. FIXME . I've commented out the following for the #. moment. The relationship between PAM and nsswitch.conf needs #. to be clearly documented in one place, which is pointed to by #. the pages for the user, group, and shadow password functions. #. (Jul 2005, mtk) #. This shadow password setup has been superseded by PAM #. (pluggable authentication modules), and the file #. .I /etc/nsswitch.conf #. now describes the sources to be used. #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The functions described below resemble those for the traditional password " "database (e.g., see B(3) and B(3))." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The B() function returns a pointer to a structure containing the " "broken-out fields of the record in the shadow password database that matches " "the username I." msgstr "" #. some systems require a call of setspent() before the first getspent() #. glibc does not #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The B() function returns a pointer to the next entry in the " "shadow password database. The position in the input stream is initialized " "by B(). When done reading, the program may call B() so " "that resources can be deallocated." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The B() function is similar to B() but uses the " "supplied stream instead of the one implicitly opened by B()." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The B() function parses the supplied string I into a struct " "I." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The B() function writes the contents of the supplied struct " "I I<*p> as a text line in the shadow password file format to " "I. String entries with value NULL and numerical entries with value " "-1 are written as an empty string." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The B() function is intended to protect against multiple " "simultaneous accesses of the shadow password database. It tries to acquire " "a lock, and returns 0 on success, or -1 on failure (lock not obtained within " "15 seconds). The B() function releases the lock again. Note " "that there is no protection against direct access of the shadow password " "file. Only programs that use B() will notice the lock." msgstr "" #. Also in libc5 #. SUN doesn't have sgetspent() #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "These were the functions that formed the original shadow API. They are " "widely available." msgstr "" #. type: SS #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Reentrant versions" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Analogous to the reentrant functions for the password database, glibc also " "has reentrant functions for the shadow password database. The " "B() function is like B() but stores the retrieved " "shadow password structure in the space pointed to by I. This shadow " "password structure contains pointers to strings, and these strings are " "stored in the buffer I of size I. A pointer to the result (in " "case of success) or NULL (in case no entry was found or an error occurred) " "is stored in I<*spbufp>." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The functions B(), B(), and B() are " "similarly analogous to their nonreentrant counterparts." msgstr "" #. SUN doesn't have sgetspent_r() #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Some non-glibc systems also have functions with these names, often with " "different prototypes." msgstr "" #. type: SS #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Structure" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The shadow password structure is defined in Ishadow.hE> as follows:" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "struct spwd {\n" " char *sp_namp; /* Login name */\n" " char *sp_pwdp; /* Encrypted password */\n" " long sp_lstchg; /* Date of last change\n" " (measured in days since\n" " 1970-01-01 00:00:00 +0000 (UTC)) */\n" " long sp_min; /* Min # of days between changes */\n" " long sp_max; /* Max # of days between changes */\n" " long sp_warn; /* # of days before password expires\n" " to warn user to change it */\n" " long sp_inact; /* # of days after password expires\n" " until account is disabled */\n" " long sp_expire; /* Date when account expires\n" " (measured in days since\n" " 1970-01-01 00:00:00 +0000 (UTC)) */\n" " unsigned long sp_flag; /* Reserved */\n" "};\n" msgstr "" #. type: SH #: 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 #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The functions that return a pointer return NULL if no more entries are " "available or if an error occurs during processing. The functions which have " "I as the return value return 0 for success and -1 for failure, with " "I set to indicate the error." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "For the nonreentrant functions, the return value may point to static area, " "and may be overwritten by subsequent calls to these functions." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The reentrant functions return zero on success. In case of error, an error " "number is returned." msgstr "" #. type: SH #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "ERRORS" msgstr "" #. type: TP #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "The caller does not have permission to access the shadow password file." msgstr "" #. type: TP #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "Supplied buffer is too small." msgstr "" #. type: SH #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "FILES" msgstr "" #. type: TP #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "local shadow password database file" msgstr "" #. type: TP #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "lock file" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The include file Ipaths.hE> defines the constant B<_PATH_SHADOW> " "to the pathname of the shadow password file." msgstr "" #. type: SH #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "ATTRIBUTES" msgstr "" #. type: Plain text #: 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(7)." msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Interface" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Attribute" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Value" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B()" msgstr "" #. type: tbl table #: 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 #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "MT-Unsafe race:getspnam locale" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B()" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "MT-Unsafe race:getspent\n" "race:spentbuf locale" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "B(),\n" "B(),\n" "B()" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "MT-Unsafe race:getspent locale" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B()" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "MT-Unsafe race:fgetspent" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B()" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "MT-Unsafe race:sgetspent" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "B(),\n" "B(),\n" "B()" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "MT-Safe locale" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "B(),\n" "B(),\n" "B()" msgstr "" #. type: tbl table #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "MT-Safe" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "" "In the above table, I in I signifies that if any of " "the functions B(), B(), B(), or " "B() are used in parallel in different threads of a program, then " "data races could occur." msgstr "" #. type: SH #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "STANDARDS" msgstr "" #. type: Plain text #: debian-bookworm msgid "" "The shadow password database and its associated API are not specified in " "POSIX.1. However, many other systems provide a similar API." msgstr "" #. type: SH #: 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 #: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "B(3), B(3), B(3), B(5)" msgstr "" #. type: TH #: debian-unstable opensuse-tumbleweed #, no-wrap msgid "2024-05-02" msgstr "" #. type: TH #: debian-unstable #, no-wrap msgid "Linux man-pages 6.8" msgstr "" #. type: tbl table #: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid ".na\n" msgstr "" #. type: tbl table #: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid ".nh\n" msgstr "" #. type: SH #: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 #: opensuse-tumbleweed #, no-wrap msgid "VERSIONS" msgstr "" #. type: Plain text #: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 #: opensuse-tumbleweed msgid "Many other systems provide a similar API." msgstr "" #. type: Plain text #: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 #: opensuse-tumbleweed msgid "None." msgstr "" #. type: TH #: fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "2023-10-31" msgstr "" #. type: TH #: fedora-40 mageia-cauldron #, no-wrap msgid "Linux man-pages 6.06" msgstr "" #. type: TH #: fedora-rawhide #, no-wrap msgid "Linux man-pages 6.7" 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 "" #. type: TH #: opensuse-tumbleweed #, no-wrap msgid "Linux man-pages (unreleased)" msgstr ""