Return to des.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / des

Annotation of 43BSDReno/usr.bin/des/des.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1989, 1990 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" This code is derived from software contributed to Berkeley by
                      5: .\" Phil Karn, derived from original work by Jim Gillogly and
                      6: .\" Richard Outerbridge.
                      7: .\"
                      8: .\" Redistribution and use in source and binary forms are permitted provided
                      9: .\" that: (1) source distributions retain this entire copyright notice and
                     10: .\" comment, and (2) distributions including binaries display the following
                     11: .\" acknowledgement:  ``This product includes software developed by the
                     12: .\" University of California, Berkeley and its contributors'' in the
                     13: .\" documentation or other materials provided with the distribution and in
                     14: .\" all advertising materials mentioning features or use of this software.
                     15: .\" Neither the name of the University nor the names of its contributors may
                     16: .\" be used to endorse or promote products derived from this software without
                     17: .\" specific prior written permission.
                     18: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     19: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     20: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     21: .\"
                     22: .\"     @(#)des.1      5.4 (Berkeley) 7/24/90
                     23: .\"
                     24: .Dd July 24, 1990
                     25: .Dt DES 1
                     26: .Os BSD 4.4
                     27: .Sh NAME
                     28: .Nm des
                     29: .Nd DES file encryption
                     30: .Sh SYNOPSIS
                     31: .Pp
                     32: .Nm Des
                     33: .Fl e
                     34: .Op bh
                     35: .Op Fl k Ar key
                     36: .Nm des
                     37: .Fl f
                     38: .Op bh
                     39: .Op Fl k Ar key
                     40: .Sh DESCRIPTION
                     41: .Nm des
                     42: is a filter that encrypts or decrypts standard input to standard output
                     43: with the Data Encryption Standard (DES).
                     44: .Pp
                     45: Options:
                     46: .Dw Ds
                     47: .Di L
                     48: .Dp Fl e
                     49: (encrypt)
                     50: .Dp Fl d
                     51: (decrypt)
                     52: .br
                     53: Either
                     54: .Fl e
                     55: or
                     56: .Fl d
                     57: must be specified.
                     58: .Pp
                     59: .Dp Fl k
                     60: If the key is not
                     61: given on the command line with the
                     62: .Fl k
                     63: option the command will prompt for it
                     64: twice, suppressing echo and comparing the two responses to guard against
                     65: mistyping.
                     66: .Pp
                     67: .Dp Fl h
                     68: The
                     69: .Fl h
                     70: flag controls how the key string is to be interpreted.
                     71: Without the
                     72: .Fl h
                     73: flag, the key is an ASCII string.
                     74: Since DES ignores the low
                     75: order bit of each key byte, the
                     76: high order bit is set for odd parity, thus retaining the information contained
                     77: in the low order bit.
                     78: If the
                     79: .Fl h
                     80: flag is set, the key string is interpreted as
                     81: 16 hex/ASCII characters; the low order bit of each byte is again ignored as per
                     82: the DES algorithm.
                     83: This allows the use of any arbitrary 56-bit key, including bytes representing
                     84: control characters that could not be typed if the -h option were not used.
                     85: .Pp
                     86: .Dp Fl b
                     87: Electronic Code
                     88: Book (ECB) mode is used.
                     89: By default, DES Cipher Block Chaining (CBC) mode is used, with an initial
                     90: vector (IV) of all zeros.
                     91: .Pp
                     92: Except for the
                     93: .Fl h
                     94: option, this command is compatible with the
                     95: .Nm des
                     96: command on the Sun Microsystems workstation.
                     97: .Dp
                     98: .Sh SEE ALSO
                     99: Sun Microsystems DES(1) manual page,
                    100: which describes in detail how
                    101: the length of the file is encoded in the last block of ciphertext.
                    102: .Sh AUTHOR
                    103: Phil Karn, KA9Q
                    104: .Sh HISTORY
                    105: 4.3Reno BSD.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.