1# $MirOS: src/share/doc/README,v 1.14 2009/11/17 19:41:04 tg Exp $
2# $OpenBSD: README,v 1.4 2004/07/29 10:50:02 jmc Exp $
3#-
4#  Copyright (c) 2005, 2008 Thorsten Glaser <tg@MirBSD.de>
5#  Copyright (c) 2004 Jason McIntyre <jmc@openbsd.org>
6#
7#  Permission to use, copy, modify, and distribute this software for any
8#  purpose with or without fee is hereby granted, provided that the above
9#  copyright notice and this permission notice appear in all copies.
10#
11#  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
12#  WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
13#  MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
14#  ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
15#  WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
16#  ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
17#  OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18
19The documents in this directory consist of various, miscellaneous, system docs:
20
21	legal/		Licences and associated information
22	html/		HTML documents for bind, curses, lynx, and milter
23	psd/		UNIX Programmer’s Supplementary Documents
24	smm/		UNIX System Manager’s Manuals
25	usd/		UNIX User’s Supplementary Documents
26
27The documentation in the psd, smm, and usd subdirectories are roff source,
28and can be used to generate documents in any of the formats available to the
29troff(1) or nroff(1) document formatting system.
30
31Within any given subdirectory, simply typing:
32
33	# make paper.ps
34
35will generate a pre-formatted document in PostScript format, called ‘paper.ps’.
36The document can be viewed with the help of a PostScript viewer, such as
37‘ghostview’ or ‘gv’, and the PostScript back-end ‘ghostscript’. See ports(7)
38and packages(7) for further information on how to install this software.
39The generation of postscript output needs an installed troff or GNU groff text
40formatter, none of which is part of the MirOS system. GNU groff can, however,
41be installed using the textproc/groff MirPort.
42
43ASCII text format documents, suitable for viewing with a pager such as
44less(1), can be generated by typing:
45
46	# make paper.txt
47
48However, the PostScript output is much prettier ☺
49
50The documentation in the html subdirectory can by viewed using any
51HTML-capable browser such as lynx(1).
52
53Note: Some of the subdirectories are empty, for a variety of reasons:
54the papers are simply out of date; the papers refer to applications no
55longer installed on the system; licencing issues; the papers have been
56superseded by GNU info(1) files, etc.
57
58
59Additional information
60----------------------
61
62This is also the place for known cryptographic information. We use gzsig(1)
63to sign our distfiles; the keys shown below are used for this purpose only.
64Please do not use them in any other way, such as SSH authorised_keys files,
65or encrypted eMail. The private key file for keys no longer in use WILL GET
66WIPED (yes, that is deleted, lost, rid of, beaten to /dev/null) afterwards.
67
68Updates to the stable branch, including security updates, are either signed
69using gzsig(1) with the then-current release public key by Thorsten Glaser,
70or, according to PGPv3 (RFC 1991) or OpenPGP (RFC 2440 or RFC 4880) with the
71following keys by Benny Siegert and Thorsten Glaser, in that order:
72
73pub  2048R/C246B025  created: 2004-01-18  expires: never       usage: SCEA
74uid                  Benny Siegert (MirOS Project) <bsiegert@66h.42h.de>
75uid                  Benny Siegert <bsiegert@gmx.de>
76 Primary key fingerprint: 70 98 4E B3 81 3F 89 FF  D6 F2 7E A2 DE E1 CD 88
77-----BEGIN PGP PUBLIC KEY BLOCK-----
78Version: 2.6.3in (MirPorts security/pgp+ pgp-2.6.3in-3)
79
80mQENA0AK9aMAAAEIALII/uTx9X8Y483xCie3o6/WHLLxqxzDix4WeFJjtFoGT5WE
81GrwzEJzl799GDaqcXoIxx9SC8dYVJPUcN8eQEqo7NCTzc75RzVG+VhjV9WbTZvcP
827HXEyMsjPpniosT4dD/cytlF9fcc1S5LGtsSQhEKct9L2YFQlDsRFXjz2Zu03aoe
83mwfeuoU93o5aHRiQoCLk7/JFnxjnr0/OKuJ+v6+5Vt4AbCQ937UPJIqjYQi+xvmJ
84eASmIayhaTr6EmB4F65dcROpi17Nl7m6HTcK5Ai9fz8s95Cn1ZCP2chK9mZ2rvh4
85kWqKKwj+ijC+vUL3BPdprL0gyevuM2aOIcJGsCUABRG0M0Jlbm55IFNpZWdlcnQg
86KE1pck9TIFByb2plY3QpIDxic2llZ2VydEA2NmguNDJoLmRlPokBFQMFE0ANVU8z
87Zo4hwkawJQEBs9oH/itQbHmolFFJc+ZQVcQ16GuxElWx2FHur18Vq4SJkl/vYgMO
88JaRmgO0PkydD3Qfligu+IU9SttSAgDHUOHBeL260akh/PMTSHYHHYBhwmrSUJdg2
89JzV0gp2xSIU+jhfP2Fuca5j0I8MzBef6//wil9o7/fiOMVg+uzVez69iFZR9LX59
90Quki982q6sdVxunVriIdIZivXn0WLTx/rmKI6HnmvdMmsRMbjytwKVuDTshZj9S8
91DWDoLv1QmkbnpHqT2S6ZOkpBE/UIszNBhlf3xcziTK2bm9hkKnZePv+xGLPTGrQk
92DOHOe50WSgO+LfiIhxLm0/tf4rHB3L6LvAxikem0H0Jlbm55IFNpZWdlcnQgPGJz
93aWVnZXJ0QGdteC5kZT6JARUDBRBACvfMM2aOIcJGsCUBAd+dB/44f6VAO351vC/P
94CsPW+nJSmRwk0v4RNJ+bCVMZjAcp2qPjKlrVThspjYZwbcGNmhDXkFzyiOASaF+L
95U6aqCtL5xs3EXDNX5H7MjFA2A5PXMpa3UGAtdqqBB6wwfKXqJ4Z3R3p/jXwK77Ue
96066rn7/bMEE6StFIJlgf+rVSYIfPEPLVgFQlIF69NxBy0sRVlqYHdR5iqW6bN7cY
97U5Qk3z2Wqbx13BBOvESdLAoT5j5pqwM5KlZZRim2peM7qjCwx+XfHA2MAHNHTWrK
98jWGAMVa4QhPaan8MIjT8BptCGB8lPSiWVeeDkkW1wN2IDXsqKcMH4tOvFbYOt4BH
99VpkG9Gx7
100=RAX5
101-----END PGP PUBLIC KEY BLOCK-----
102
103pub  4096R/E99007E0  created: 2007-03-11  expires: 2014-03-09  usage: SCEA
104uid                  Thorsten Glaser <tg@mirbsd.de>
105 Primary key fingerprint: 9031 955E 7A97 A4FD A32B  2B86 76B5 34B2 E990 07E0
106-----BEGIN PGP PUBLIC KEY BLOCK-----
107Version: GnuPG v1.4.7 (MirBSD)
108
109mQINBEX0aiMBEADhUiTT2IxB/DIpLbxhzep9fXLQquSo42zbYyjtjFDOSu3hXrC4
110J+70oHJtN2XNv1703iHomJKc/GsB6sxWIHa4Z9mAQME3ivV1GkqdFnafBTTHqKYl
111LAEzfBXqq5sH8y55DlLkAvFYHcTCASQSW2IAPZnh0vx1KOHl7HRTKHVi2rqV0a5h
1121m5N7T5JHQeqASPBh4kBg3MDYFNTDVGhbY91hRhsWvJAA4592TpaZmkIRqVY+nfl
113wT/RIh1JBOWZK4A8TG/ewpty1SvZj0AmDzDvNTy4xWgTCJxizlevI5lt05QpWerg
114Mg2ZZA1cNx9FHlxEj+42QmZpXcJ38gzcFZQfSFcNyiC6AFFJeew978E7xsVHKohs
1158fqo94zXguPmhoZP5VNRkxCqz/HwjhgmFvB3eJEqTWK3DD7zYFs7RkkSH158yXiO
1165krWZzzZLA4+38SXH1FOA2DhfhQCjOVTmElUCwhZ/gOgWEayGZfUDduO5fs4Tfnz
117fb2/xQe1Of9qWJy4ptc1HxCIYMsOu7kud4ox5LQA1GvF1UspK0XuXCBfDujmBBVy
118JAwlbFXbH7p0GqHpj8WTiQCOHUMytWxdOuG3ysi6fW10VZLEPcJDdwJbmOb1WePj
1191jTT0jZnHd2pAipAP7UwKDPaY+gCgBLbh8N3GZ71l+9JWPnuiyxT8N9FEQARAQAB
120tFBUaG9yc3RlbiBHbGFzZXIgKG5vIFBHUC9NSU1FIHBsZWFzZSwgdXNlIElubGlu
121ZSBPcGVuUEdQIGluc3RlYWQpIDx0Z0BtaXJic2Qub3JnPokCjQQTAQIAdwIbLwUJ
122DShogAULCAQJBwUVAwkKCAMWAgACHgECF4ACGQEZGGhrcDovL3BncGtleXMucGNh
123LmRmbi5kZQUCSoxsiTQUgAAAAAAgAAtwcmVmZXJyZWQtZW1haWwtZW5jb2RpbmdA
124cGdwLmNvbXBhcnRpdGlvbmVkAAoJEHa1NLLpkAfgaR0QAI2AcjxbLZ3TD/aQX1f3
125cuYKGpHYDtBYsML7/Hnm8K4Ouq/+H01Y733Q/8PVjcZHad4Z3NJLORIOys0EP+30
126uTMG+oylSx3dbMocCbBTL+am1EYZCMMNuCPvarHfBorq2ck+UUJ8sqjx0y7+tpIN
127IoJHhctU55EJwHXWR8PhncHBzsxFFd+ZYt2OC8cMbhzXEcdX1u/IrUH9J07baULd
128s5Okvs0XzoKn7Afy18BuReBUwC90bUm5m7FBnuxw+z9TEg/U6BJXDtjXdQhstTjT
1294J5Buk4JSgIyemGxAFrXy48RQTsBhzGVuRtAs5bAnnzYLmsa+8Gn4mTJL1XxMvEI
1304XU8XA13anTE5Ddz81mB5cTwQoG4NHe/TVKj1dV9AHp4cbONgXzTvWW41nd3uUtD
131/duNI4YZHSermfKzO/kyGsq3WgkdH6czeWS52FvRW62Oj+I0AGtdngp+xCg2fsGx
132UNJZvOVDlmLhlclt41bpOLSs1VKYDtUO7JJKo05/MYyJPYKv7XPo3jHtjeWCTqPZ
133eMTqnPjuueTtVvZFmk8Lkm3DCpIDtGN1QQZe7YdkA6LgnONhDt0M09nYTRMaJmkD
134ze84Q+GdJKXHYmuRfV2cKCQuM3ohMGxESVyRjQjGh0J0jO/rPseIJS4+XT7Wnw5R
135vWsdlR08iPG1tISfg5uQSn6htB5UaG9yc3RlbiBHbGFzZXIgPHRnQG1pcmJzZC5k
136ZT6JAooEEwECAHQCGy8FCQ0oaIACHgECF4AFCwgECQcFFQMJCggDFgIAGRhoa3A6
137Ly9wZ3BrZXlzLnBjYS5kZm4uZGUFAkqMbII0FIAAAAAAIAALcHJlZmVycmVkLWVt
138YWlsLWVuY29kaW5nQHBncC5jb21wYXJ0aXRpb25lZAAKCRB2tTSy6ZAH4ENxD/9l
1391RtLj8v+eS89sCsCdske09W9H8bmwvN3iz8onOT2y5czwUXvYLSx+LmXNtuNP05W
140LdDAzI+mNYtrwyMnEgkxvGNlJxPu4pvtV+halqmubu0AdWNPIq4I+hTWQeEVchP8
141ku0bZYOFsFoJ2FhHZhjDuP3AMuBIIt124Ia43hQDwRM6YX9OnxC4fKxETeLMQvIU
142q96fXusFFCiuabHjLSpikYR/S8TCFkX28DYj8CNyuNYR1nrK4oNm136o0I/mjMof
143NkulE70WoVCtShlu7xdaq0/26ObHXgFRlyrqlacY0kvxUuKv6HjhVAiBp8G3OHu5
144Ch8TBE3Oqpqjfsed+1mkW+pYI5UlfWTsrHSfBKRi20Gd6CISlMjBVnz1FI1Jwz1A
145DrNABk1UaYiKcAI9o9gl9Re3UUzeHq2+ghPEqF+oERTxAHcKRwo3C+pyW5S5fv/E
1462+G0WUXOhu9JRyZEjNfQ2ICqzPaRbfnpEsRwkt4WlfpCagX0MaZWmdodlGdFWsYl
147K03Pppx5ZKoLhT5wadiMp4piBO4vIoU8mVDujoBrztk7GHjQ+vxme3ywrrIEcRvg
148JGJYzKJYd0b+012NwVHrtJG01mT8hI/yx15snPDNXkKJVtfxrUNasYzRDXwPSms9
149hTwyr7VeLLBxgUGoDooC2d3KHssvdjYbfAixblrM7rQzVGhvcnN0ZW4gR2xhc2Vy
150IChETSwgbm90IERELi4uIHlldCkgPHRnQGRlYmlhbi5vcmc+iQKKBBMBAgB0Ahsv
151BQkNKGiAAh4BAheABQsIBAkHBRUDCQoIAxYCABkYaGtwOi8vcGdwa2V5cy5wY2Eu
152ZGZuLmRlBQJKjGyMNBSAAAAAACAAC3ByZWZlcnJlZC1lbWFpbC1lbmNvZGluZ0Bw
153Z3AuY29tcGFydGl0aW9uZWQACgkQdrU0sumQB+CHiw//WUSqC1TJFeHR0D49sE1G
154/3RLQmVsvDBwe2i2pA3dWtgdB3k08o3aan1Y+kxPgzCZLAILg3G2FslaMTLq+fT0
155Lcb6VgraeJXfaWVVpo1O2en3nkKTxYmNwaLOHuF9L3BSnGmIoY7qw8v7tNQ+f1o+
156O7segIm/W8v3l2zxaxUpd2x00rrVIUtggp1fHRonjdIhNsF98+dwMjqfz4TgJKRj
157/inIOJ1jgnUTTc+pocrZ49u5odCNlZuVuw24guujWihmiFWTDb0/sCUnyY9Tch6H
158NOXuafPCrRBUOv35H4Te8ZNXuGPHYaEFnofJih6CdDpql2hRWzlnS2QLi4b/lnuc
159w0E9v335TnkzMgpp8S3eP1NpLkr7RuEf+2ihOHm4TALuz2ScTu0qotg0DLIvl+/r
160UdByotvMjb25qo06XHYj/nsbHPEJPNJCs+nhmXfA79C8HSpxl4E0twP+m3EsKfRO
161sIXWV/JCTgYMKJ5dVbftGMgAymsAtM0DiEjDSQtHM/pGyv0Ar79YNmBfC77FnJbG
162GY3+yeEOEGBWVAIMksgnIbjvK3Oc5R6urUS/bijBqzCakWq4cN1NVxbNHps2fnSC
1635n+j+g2OkdXQYEtAIo52+EfcJbPUNGk+h4p1WlyrdZYLdfxLspzLeQ76B1B3FiBF
164uQQA9i65Bdg96+kPPOsV444=
165=KDRU
166-----END PGP PUBLIC KEY BLOCK-----
167
168
169gzsig(1) keys (must be last):
170
171Key 1 was active from the very beginning until March 17th, 2006.
172Key 2 is currently in use, starting March 18th, 2006.
173
174key 1:	ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAoEAy5akQiuw0znRhMD0djgQ7BiUPahG1QHJb9ZNApd6D5OnV98FO8Ofbfm4CF1Cvwr+IPnyKyPglQnaFgHF3LVynKMYSupKXnd0JrBR79TBmIVImBnIaTPcApRdWZEbMW5IdYhrWFHKlzk4vDxBXdcVE6QfiemWsYqkiuoJvLTLHXq7WUCQ5z7KuQetMnnP2bswV8SZuYy0IvzQRBVJbiTQzBvsHfyZUERLBZvjtPE9jTaLdTOkKvCuhuTzQAMmG8aYFt9S0p1K20eCCgWvJ5vu3ir875yBrtVPl2VzdFdo7Wv3kg1HOV+Sy7dQ2bIJ52mV8CnHI1W+ZMEjzQ64m75wH/AGsVb35E0sPJzFNCGj//8/kyKxRR1I0DSDOb+iE48twOrBRrUF5+ApwocqVdIa//Cbe1ArjzrEhwaKY0SitPcFwbVV8XadtsHXfdM5QnFwTsNobk2w+XLt9I5yL/SdE1NVVXBsAN1nejzDo8XTheD6o/m5O29WO3MSS7jt1PCYItVjN4ONK/Ztaa+zQcNK9itMy2tEJ1R/gI+AipOQi0JaHHAjcdYKxDbbJpurJAHvtLvKiJNqNUJPGpqCSfL8YqmDwf3Gs1SntRjgZNeOpAdiHl2qUewcB2vujROmLTQgxJ2HJTK8hKr+2nkZdEMkYYQ/wDtsGYohokU1GOGTjdr5d2vXW8MAWaF5UQDXQzPCT4RGjDLfvod4SM+GHn8t2eDJH8uHvUPU6AXcohM30zw/h9FPf18q7Oo0srwFpc0qjvwDxl9lgilsfaL23K2V5YFeTkO1llxnRdsTmSZ7UMsugBFu5bjGEL4hC/Sml0oH9F8hiV50fXWetsQvNB637Q== Thorsten "mirabilos" Glaser <tg@MirBSD.org> SIGN
175key 2:	ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAEAQDAezwU2y/8Wc6rQcqqcAq17khQOijUcUih2SHt2CumxbblbTy0uJq5VFeVdo2Au2ynSlq8/EmsNMh7gMqUOo46F/+wx249Hcr2iUVuhzsDtKrKqcY4+cGA1ytGxnHdot9jl6NDsdyyMXp7dE6SmMhXfb2M7NMtNryQeQmpNytU//dKw8dNYGizIrkHxxQOM1Uhbec7blJBn1GhDmcI6Hfc1QtZBSW9qnpjAE4xAe6RXksXyA72DnxOAJJj0bv5zBCIJSPGUWuHpgkV8JUsezumRV52ejgqkJn6Pa5MGFN3tNGp99meMJlNJTFZ0q0mRrDH/pQQTg40qHjMHUSM/8ilqpkOJ5fkP7DwOCCrPgMj3GvCUXWnW1joI54lKMyaFdiO53QsyqbOjuTB2xBlc/oO8eKKIEP2Woo/WzGyModa7DePdYklWHUYF1AI70dd3SrntzB6UR8itkBsXn+oUWWwixNsbUX1Ud1UtkpNLn34zFBQ6IiFgEO6LinycgYpVJ7yeavt0ti74E6ACuYTHrKVSKm4cGwiqFlxg+gGgrtlDG0n8530XVmtEYcb8m0T/MFf0QW52ZAp6JXqkrDKrJzSfIMSQ85bPOu3ZJ9T8Q56TgdEqMzhIZzpQGrXygfMBA/NpvuAs8mzL9lqYgmDxUj5FSHO7kg3gWgJ9gmtH1yjxxDjezhaJvWiQ2cNnyTSdjM1l7PyeZ1TU08ZefcJ12z63qYwAKL2gfEwsi6gZKqWp3b9i0axyvN3zeQA5AnUujHboeWE47Xy/8OWTcMfhU95/nunc+KSH449HaYNpR22vEtkJRKhoopanlCu1CfyCQV9W/97OqZBHBLlhC8FOdSf1Jg0Yg8aPG77s7XVbfRBC5JTCUCck3Ym/zzcVCmc+4mn8hA+zCzEYNpkfptHvND4oZ9CCkQZuI/YuAqPVqjhmOcYpgTvwVefSVTAy5HqKPkYwoX/EmZwV+jZhSprEJdEg1uinTJxKvVcvHkvNsi/0z+EvOalkGdl+oYKA04rNfq9FGE19iHHa7RwIQxnIc905CBTzH9zBUqWivU11v/sdPklx86oanavt5W7Yaq7Ksirh4GpeVMGS1i51Otml2JihmGeRpuzn+ERpYodRCMopCGkJHZqDjbB6K884EH4GJ3CQWi0OD/1rd84GQZKg++CvJdeO2rzqdYeEJLU/CpQSz7xo8mzGQCa4Pl26df2W/RA/wCnmcOz//dALG30rFHYBt+MEIACXdBz+QQBRQf0ycOjjrFfWMRqFVv9ACEZ16faXiB6t+bLzhvFWgRA+fC/3wa9qmjgF2zISnZ4hsbnQDmfcuJs1WqeYpluYzgGng3MBxEG7L5cz2xwU98XSVEn Thorsten Glaser <signcode@mirbsd.de>
176