man*/: ffix (un-bracket tables)

[thirdparty/man-pages.git] / man3 / xcrypt.3

diff --git a/man3/xcrypt.3 b/man3/xcrypt.3
index 4c537453becb144f8c99f03c9e2b758bd1448f65..55bdd51f5d92d7461fbac6bede2a7665524ba5bb 100644 (file)
--- a/man3/xcrypt.3
+++ b/man3/xcrypt.3
@@ -1,8 +1,7 @@
+'\" t
 .\"  Copyright 2003 walter harms (walter.harms@informatik.uni-oldenburg.de)
 .\"
-.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
-.\"  Distributed under GPL
-.\" %%%LICENSE_END
+.\" SPDX-License-Identifier: GPL-1.0-or-later
 .\"
 .\"  this is the 3rd type of interface for cryptographic routines
 .\"  1. encrypt() expects a bit field
@@ -10,18 +9,26 @@
 .\"  3. xencrypt() a hexstring
 .\"  to bad to be true :(
 .\"
-.TH XCRYPT 3 2014-08-19 "" "Linux Programmer's Manual"
+.TH XCRYPT 3 (date) "Linux man-pages (unreleased)"
 .SH NAME
 xencrypt, xdecrypt, passwd2des \- RFS password encryption
+.SH LIBRARY
+Standard C library
+.RI ( libc ", " \-lc )
 .SH SYNOPSIS
+.nf
 .B "#include <rpc/des_crypt.h>"
-.sp
+.PP
 .BI "void passwd2des(char " *passwd ", char *" key ");"
-.sp
+.PP
 .BI "int xencrypt(char *" secret ", char *" passwd ");"
-.sp
 .BI "int xdecrypt(char *" secret ", char *" passwd ");"
+.fi
 .SH DESCRIPTION
+.BR WARNING :
+Do not use these functions in new code.
+They do not achieve any type of acceptable cryptographic security guarantees.
+.PP
 The function
 .BR passwd2des ()
 takes a character string
@@ -37,7 +44,7 @@ Both other functions described here use this function to turn their
 argument
 .I passwd
 into a DES key.
-.LP
+.PP
 The
 .BR xencrypt ()
 function takes the ASCII character string
@@ -54,7 +61,7 @@ and outputs the result again in
 as a hex string
 .\" (over the alphabet 0123456789abcdef)
 of the same length.
-.LP
+.PP
 The
 .BR xdecrypt ()
 function performs the converse operation.
@@ -64,23 +71,25 @@ The functions
 and
 .BR xdecrypt ()
 return 1 on success and 0 on error.
-.SH VERSIONS
-These functions are available in glibc since version 2.1.
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
 .BR attributes (7).
 .TS
 allbox;
-lbw37 lb lb
+lbx lb lb
 l l l.
 Interface      Attribute       Value
 T{
+.na
+.nh
 .BR passwd2des (),
 .BR xencrypt (),
 .BR xdecrypt ()
 T}     Thread safety   MT-Safe
 .TE
-
+.sp 1
+.SH VERSIONS
+These functions are available since glibc 2.1.
 .SH BUGS
 The prototypes are missing from the abovementioned include file.
 .SH SEE ALSO