update db2-hash-routines.8 to include sha1_hex

[ci skip]

Author: tessus

man/man8/db2-hash-routines.8

@@ -1,4 +1,4 @@
-.TH db2-hash-routines "8" "May 2017" "db2-hash-routines 1.8" "DB2 UDFs and Stored Procedures"
+.TH db2-hash-routines "8" "August 2017" "db2-hash-routines 1.8" "DB2 UDFs and Stored Procedures"
 .SH NAME
 db2-hash-routines \- DB2 UDFs and SPs to generate and validate hashes
 .SH SYNOPSIS
@@ -18,6 +18,8 @@ db2-hash-routines \- DB2 UDFs and SPs to generate and validate hashes
 .PP
 >>-SHA256_HEX--(--expression--)--------------------------------><
 .PP
+>>-SHA1_HEX--(--expression--)----------------------------------><
+.PP
 .nf
 >>-SHA256--(--expression--+---------+--)-----------------------><
                           '-,--salt-'
@@ -46,6 +48,8 @@ db2-hash-routines \- DB2 UDFs and SPs to generate and validate hashes
 .PP
 >>-SHA256_HEX--(--expression--,--hash--)-----------------------><
 .PP
+>>-SHA1_HEX--(--expression--,--hash--)-------------------------><
+.PP
 .nf
 >>-SHA256--(--expression--+---------+--,--hash--)--------------><
                           '-,--salt-'
@@ -144,6 +148,18 @@ The argument can be a character string that is either a CHAR or VARCHAR not exce
 .IP
 The result of the routine is CHAR(64). The result can be null; if the argument is null, the result is the null value.
 .TP
+\fBsha1_hex( '\fR\fIcleartext\fR\fB' )\fR
+.RS 0
+\fBsha1_hex( '\fR\fIcleartext\fR\fB', \fR\fI:hash\fR\fB )\fR
+.PD 0
+.IP
+SHA1 algorithm. The sha1_hex routine returns a 40-character hexadecimal hash.
+.PD
+.IP
+The argument can be a character string that is either a CHAR or VARCHAR not exceeding 4096 bytes.
+.IP
+The result of the routine is CHAR(40). The result can be null; if the argument is null, the result is the null value.
+.TP
 \fBsha256( '\fR\fIcleartext\fR\fB' [, '\fR\fIsalt\fR\fB'] )\fR
 .RS 0
 \fBsha256( '\fR\fIcleartext\fR\fB' [, '\fR\fIsalt\fR\fB'], \fR\fI:hash\fR\fB )\fR
@@ -424,6 +440,40 @@ CALL sha256_hex('testpwd', ?)
   Return Status = 0
 .fi
 .PP
+\fBsha1_hex(1):\fR
+.br
+Inserting the user \fItest\fR and the sha1 crypted clear text \fItestpwd\fR to the table \fIusers\fR.
+.PP
+.nf
+INSERT INTO USERS (username, password)
+  VALUES ('test', sha1_hex('testpwd'))
+.fi
+.PP
+\fBsha1_hex(2):\fR
+.br
+.nf
+SELECT sha1_hex('testpwd') FROM SYSIBM.SYSDUMMY1
+
+1
+----------------------------------------
+98ef0758e6aac6f9a9e1197548c8190b72c9581d
+
+  1 record(s) selected.
+.fi
+.PP
+\fBsha1_hex(3):\fR
+.br
+.nf
+CALL sha1_hex('testpwd', ?)
+
+  Value of output parameters
+  --------------------------
+  Parameter Name  : HASH
+  Parameter Value : 98ef0758e6aac6f9a9e1197548c8190b72c9581d
+
+  Return Status = 0
+.fi
+.PP
 \fBsha256 (1):\fR
 .br
 Inserting the user \fItest\fR and the sha256 crypted clear text \fItestpwd\fR to the table \fIusers\fR.