path: root/templates/man3/crypt.3.pot

# 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: 2023-06-27 19:23+0200\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: Dd
#: debian-bookworm debian-unstable
#, no-wrap
msgid "October 11, 2017"
msgstr ""

#. type: Dt
#: debian-bookworm debian-unstable
#, no-wrap
msgid "CRYPT 3"
msgstr ""

#. type: Os
#: debian-bookworm debian-unstable
#, no-wrap
msgid "Openwall Project"
msgstr ""

#. type: Sh
#: debian-bookworm debian-unstable
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid "E<.Nm crypt , crypt_r , crypt_rn , crypt_ra>"
msgstr ""

#. type: Nd
#: debian-bookworm debian-unstable
#, no-wrap
msgid "passphrase hashing"
msgstr ""

#. type: Sh
#: debian-bookworm debian-unstable
#, no-wrap
msgid "LIBRARY"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid "E<.Lb libcrypt>"
msgstr ""

#. type: Sh
#: debian-bookworm debian-unstable
#, no-wrap
msgid "SYNOPSIS"
msgstr ""

#. type: In
#: debian-bookworm debian-unstable
#, no-wrap
msgid "crypt.h"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"E<.Ft \"char *\"> E<.Fo crypt> E<.Fa \"const char *phrase\"> E<.Fa \"const "
"char *setting\"> E<.Fc> E<.Ft \"char *\"> E<.Fo crypt_r> E<.Fa \"const char "
"*phrase\"> E<.Fa \"const char *setting\"> E<.Fa \"struct crypt_data *data\"> "
"E<.Fc> E<.Ft \"char *\"> E<.Fo crypt_rn> E<.Fa \"const char *phrase\"> E<.Fa "
"\"const char *setting\"> E<.Fa \"struct crypt_data *data\"> E<.Fa \"int "
"size\"> E<.Fc> E<.Ft \"char *\"> E<.Fo crypt_ra> E<.Fa \"const char "
"*phrase\"> E<.Fa \"const char *setting\"> E<.Fa \"void **data\"> E<.Fa \"int "
"*size\"> E<.Fc>"
msgstr ""

#. type: Sh
#: debian-bookworm debian-unstable
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"The E<.Nm crypt>, E<.Nm crypt_r>, E<.Nm crypt_rn>, and E<.Nm crypt_ra> "
"functions irreversibly E<.Dq hash> E<.Fa phrase> for storage in the system "
"password database E<.Pq Xr shadow 5> using a cryptographic E<.Dq hashing "
"method.> The result of this operation is called a E<.Dq hashed passphrase> "
"or just a E<.Dq hash.> Hashing methods are described in E<.Xr crypt 5>."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"E<.Fa setting> controls which hashing method to use, and also supplies "
"various parameters to the chosen method, most importantly a random E<.Dq "
"salt> which ensures that no two stored hashes are the same, even if the E<."
"Fa phrase> strings are the same."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"The E<.Fa data> argument to E<.Nm crypt_r> is a structure of type E<.Vt "
"\"struct crypt_data\">.  It has at least these fields:"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
#, no-wrap
msgid ""
"struct crypt_data {\n"
"    char output[CRYPT_OUTPUT_SIZE];\n"
"    char setting[CRYPT_OUTPUT_SIZE];\n"
"    char input[CRYPT_MAX_PASSPHRASE_SIZE];\n"
"    char initialized;\n"
"};\n"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"Upon a successful return from E<.Nm crypt_r>, the hashed passphrase will be "
"stored in E<.Fa output>.  Applications are encouraged, but not required, to "
"use the E<.Fa input> and E<.Fa setting> fields to store the strings that "
"they will pass as E<.Fa input phrase> and E<.Fa setting> to E<.Nm crypt_r>.  "
"This will make it easier to erase all sensitive data after it is no longer "
"needed."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"The E<.Fa initialized> field must be set to zero before the first time a E<."
"Vt \"struct crypt_data\"> object is first used in a call to E<.Fn crypt_r>.  "
"We recommend zeroing the entire object, not just E<.Fa initialized> and not "
"just the documented fields, before the first use.  (Of course, do this "
"before storing anything in E<.Fa setting> and E<.Fa input>.)"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"The E<.Fa data> argument to E<.Nm crypt_rn> should also point to a E<.Vt "
"\"struct crypt_data\"> object, and E<.Fa size> should be the size of that "
"object, cast to E<.Vt int>.  When used with E<.Nm crypt_rn>, the entire E<."
"Fa data> object (except for the E<.Fa input> and E<.Fa setting> fields) must "
"be zeroed before its first use; this is not just a recommendation, as it is "
"for E<.Nm crypt_r>.  Otherwise, the fields of the object have the same uses "
"that they do for E<.Nm crypt_r>."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"On the first call to E<.Nm crypt_ra>, E<.Fa data> should be the address of a "
"E<.Vt \"void *\"> variable set to NULL, and E<.Fa size> should be the "
"address of an E<.Vt int> variable set to zero.  E<.Nm crypt_ra> will "
"allocate and initialize a E<.Vt \"struct crypt_data\"> object, using E<.Xr "
"malloc 3>, and write its address and size into the variables pointed to by "
"E<.Fa data> and E<.Fa size>.  These can be reused in subsequent calls.  "
"After the application is done hashing passphrases, it should deallocate the "
"E<.Vt \"struct crypt_data\"> object using E<.Xr free 3>."
msgstr ""

#. type: Sh
#: debian-bookworm debian-unstable
#, no-wrap
msgid "RETURN VALUES"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"Upon successful completion, E<.Nm crypt>, E<.Nm crypt_r>, E<.Nm crypt_rn>, "
"and E<.Nm crypt_ra> return a pointer to a string which encodes both the "
"hashed passphrase, and the settings that were used to encode it.  This "
"string is directly usable as E<.Fa setting> in other calls to E<.Nm crypt>, "
"E<.Nm crypt_r>, E<.Nm crypt_rn>, and E<.Nm crypt_ra>, and as E<.Fa prefix> "
"in calls to E<.Nm crypt_gensalt>, E<.Nm crypt_gensalt_rn>, and E<.Nm "
"crypt_gensalt_ra>.  It will be entirely printable ASCII, and will not "
"contain whitespace or the characters E<.Sq Li \\&:>, E<.Sq Li \\&;>, E<.Sq "
"Li \\&*>, E<.Sq Li \\&!>, or E<.Sq Li \\&\\e>.  See E<.Xr crypt 5> for more "
"detail on the format of hashed passphrases."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"E<.Nm crypt> places its result in a static storage area, which will be "
"overwritten by subsequent calls to E<.Nm crypt>.  It is not safe to call E<."
"Nm crypt> from multiple threads simultaneously."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"E<.Nm crypt_r>, E<.Nm crypt_rn>, and E<.Nm crypt_ra> place their result in "
"the E<.Fa output> field of their E<.Fa data> argument.  It is safe to call "
"them from multiple threads simultaneously, as long as a separate E<.Fa data> "
"object is used for each thread."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"Upon error, E<.Nm crypt_r>, E<.Nm crypt_rn>, and E<.Nm crypt_ra> write an E<."
"Em invalid> hashed passphrase to the E<.Fa output> field of their E<.Fa "
"data> argument, and E<.Nm crypt> writes an invalid hash to its static "
"storage area.  This string will be shorter than 13 characters, will begin "
"with a E<.Sq Li \\&*>, and will not compare equal to E<.Fa setting>."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"Upon error, E<.Nm crypt_rn> and E<.Nm crypt_ra> return a null pointer.  E<."
"Nm crypt_r> and E<.Nm crypt> may also return a null pointer, or they may "
"return a pointer to the invalid hash, depending on how libcrypt was "
"configured.  (The option to return the invalid hash is for compatibility "
"with old applications that assume that E<.Nm crypt> cannot return a null "
"pointer.  See E<.Sx PORTABILITY NOTES> below.)"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid "All four functions set E<.Va errno> when they fail."
msgstr ""

#. type: Sh
#: debian-bookworm debian-unstable
#, no-wrap
msgid "ERRORS"
msgstr ""

#. type: It
#: debian-bookworm debian-unstable
#, no-wrap
msgid "Er EINVAL"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"E<.Fa setting> is invalid, or requests a hashing method that is not "
"supported."
msgstr ""

#. type: It
#: debian-bookworm debian-unstable
#, no-wrap
msgid "Er ERANGE"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"E<.Fa phrase> is too long (more than E<.Dv CRYPT_MAX_PASSPHRASE_SIZE> "
"characters; some hashing methods may have lower limits)."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"E<.Nm crypt_rn> only: E<.Fa size> is too small for the hashing method "
"requested by E<.Fa setting>."
msgstr ""

#. type: It
#: debian-bookworm debian-unstable
#, no-wrap
msgid "Er ENOMEM"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid "Failed to allocate internal scratch memory."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid "E<.Nm crypt_ra> only: failed to allocate memory for E<.Fa data>."
msgstr ""

#. type: It
#: debian-bookworm debian-unstable
#, no-wrap
msgid "Er ENOSYS No or Er EOPNOTSUPP"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"Hashing passphrases is not supported at all on this installation, or the "
"hashing method requested by E<.Fa setting> is not supported.  These error "
"codes are not used by this version of libcrypt, but may be encountered on "
"other systems."
msgstr ""

#. type: Sh
#: debian-bookworm debian-unstable
#, no-wrap
msgid "PORTABILITY NOTES"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"E<.Nm crypt> is included in POSIX, but E<.Nm crypt_r>, E<.Nm crypt_rn>, and "
"E<.Nm crypt_ra> are not part of any standard."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"POSIX does not specify any hashing methods, and does not require hashed "
"passphrases to be portable between systems.  In practice, hashed passphrases "
"are portable as long as both systems support the hashing method that was "
"used.  However, the set of supported hashing methods varies considerably "
"from system to system."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"The behavior of E<.Nm crypt> on errors isn't well standardized.  Some "
"implementations simply can't fail (except by crashing the program), others "
"return a null pointer or a fixed string.  Most implementations don't set E<."
"Va errno>, but some do.  POSIX specifies returning a null pointer and "
"setting E<.Va errno>, but it defines only one possible error, E<.Er ENOSYS>, "
"in the case where E<.Nm crypt> is not supported at all.  Some older "
"applications are not prepared to handle null pointers returned by E<.Nm "
"crypt>.  The behavior described above for this implementation, setting E<.Va "
"errno> and returning an invalid hashed passphrase different from E<.Fa "
"setting>, is chosen to make these applications fail closed when an error "
"occurs."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"Due to historical restrictions on the export of cryptographic software from "
"the USA, E<.Nm crypt> is an optional POSIX component.  Applications should "
"therefore be prepared for E<.Nm crypt> not to be available, or to always "
"fail (setting E<.Va errno> to E<.Er ENOSYS>)  at runtime."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid "POSIX specifies that E<.Nm crypt> is declared in"
msgstr ""

#. type: In
#: debian-bookworm debian-unstable
#, no-wrap
msgid "unistd.h ,"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"but only if the macro E<.Dv _XOPEN_CRYPT> is defined and has a value greater "
"than or equal to zero.  Since libcrypt does not provide"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"it declares E<.Nm crypt>, E<.Nm crypt_r>, E<.Nm crypt_rn>, and E<.Nm "
"crypt_ra> in"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid "instead."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"On a minority of systems (notably recent versions of Solaris), E<.Nm crypt> "
"uses a thread-specific static storage buffer, which makes it safe to call "
"from multiple threads simultaneously, but does not prevent each call within "
"a thread from overwriting the results of the previous one."
msgstr ""

#. type: Sh
#: debian-bookworm debian-unstable
#, no-wrap
msgid "BUGS"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"Some implementations of E<.Nm crypt>, upon error, return an invalid hash "
"that is stored in a read-only location or only initialized once, which means "
"that it is only safe to erase the buffer pointed to by the E<.Nm crypt> "
"return value if an error did not occur."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"E<.Vt \"struct crypt_data\"> may be quite large (32kB in this implementation "
"of libcrypt; over 128kB in some other implementations).  This is large "
"enough that it may be unwise to allocate it on the stack."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"Some recently designed hashing methods need even more scratch memory, but "
"the E<.Nm crypt_r> interface makes it impossible to change the size of E<.Vt "
"\"struct crypt_data\"> without breaking binary compatibility.  The E<.Nm "
"crypt_rn> interface could accommodate larger allocations for specific "
"hashing methods, but the caller of E<.Nm crypt_rn> has no way of knowing how "
"much memory to allocate.  E<.Nm crypt_ra> does the allocation itself, but "
"can only make a single call to E<.Xr malloc 3>."
msgstr ""

#. type: Sh
#: debian-bookworm debian-unstable
#, no-wrap
msgid "ATTRIBUTES"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"For an explanation of the terms used in this section, see E<.Xr attributes "
"7>."
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable
#, no-wrap
msgid "Interface"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable
#, no-wrap
msgid "Attribute"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable
#, no-wrap
msgid "Value"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable
#, no-wrap
msgid ".Nm crypt\n"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable
#, no-wrap
msgid "Thread safety"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable
#, no-wrap
msgid "MT-Unsafe race:crypt"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable
#, no-wrap
msgid ".Nm crypt_r ,\n"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable
#, no-wrap
msgid ".Nm crypt_rn ,\n"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable
#, no-wrap
msgid ".Nm crypt_ra\n"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable
#, no-wrap
msgid "MT-Safe"
msgstr ""

#. type: Sh
#: debian-bookworm debian-unstable
#, no-wrap
msgid "HISTORY"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"A rotor-based E<.Nm crypt> function appeared in E<.At v6>.  The E<.Dq "
"traditional> DES-based E<.Nm crypt> first appeared in E<.At v7>."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"E<.Nm crypt_r> originates with the GNU C Library.  There's also a E<.Nm "
"crypt_r> function on HP-UX and MKS Toolkit, but the prototypes and semantics "
"differ."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"E<.Nm crypt_rn> and E<.Nm crypt_ra> originate with the Openwall project."
msgstr ""

#. type: Sh
#: debian-bookworm debian-unstable
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable
msgid ""
"E<.Xr crypt_gensalt 3>, E<.Xr getpass 3>, E<.Xr getpwent 3>, E<.Xr shadow "
"3>, E<.Xr login 1>, E<.Xr passwd 1>, E<.Xr crypt 5>, E<.Xr passwd 5>, E<.Xr "
"shadow 5>, E<.Xr pam 8>"
msgstr ""