2 .\" enigma (aka. crypt) man page written by Joerg Wunsch.
4 .\" Since enigma itself is distributed in the Public Domain, this file
7 .\" $FreeBSD: src/usr.bin/enigma/enigma.1,v 1.5.2.2 2002/06/20 23:45:48 charnier Exp $
8 .\" $DragonFly: src/usr.bin/enigma/enigma.1,v 1.2 2003/06/17 04:29:26 dillon Exp $
16 .Nd very simple file encryption
29 utility, also known as
33 simple encryption program, working on a
35 basis. It operates as a filter, i. e. it encrypts or decrypts a
36 stream of data from standard input, and writes the result to standard
37 output. It automatically detects whether the input data stream is
38 already encrypted, and switches into decryption mode in this case.
40 There are several ways to provide the secret key to the program. By
41 default, the program prompts the user on the controlling terminal for
44 This is the only safe way of providing it.
46 Alternatively, the key can be provided as the sole command-line
49 when starting the program. Obviously, this way the key can easily be
50 spotted by other users running
52 As yet another alternative,
54 can be given the option
56 and it will take the key from the environment variable
58 While this at a first glance seems to be more secure than the previous
59 option, it actually isn't since environment variables can also be
62 Thus this option is mainly provided for compatibility with other
66 When specifying the option
69 modifies the encryption engine in a way that is supposed to make it a
70 little more secure, but incompatible with other implementations.
73 The cryptographic value of
75 is rather small. This program is only provided here for compatibility
76 with other operating systems that also provide an implementation. For
77 real encryption, refer to
79 (from the DES distribution package), or
81 (from the ports collection). However, restrictions for exporting,
82 importing or using such tools might exist in some countries, so those
83 stronger programs are not being shipped as part of the operating
86 .Bl -tag -offset indent -width "XXCrYpTkEy"
88 used to obtain the secret key when option
93 .Bd -literal -offset indent
94 man enigma | enigma > encrypted
95 Enter key: (XXX \(em key not echoed)
98 This will create an encrypted form of this man page, and store it in
101 .Bd -literal -offset indent
102 enigma XXX < encrypted
105 This displays the previously created file on the terminal.
114 are very common among
116 operating systems. This implementation has been taken from the
117 .Em Cryptbreakers Workbench
118 which is in the public domain.