1
<?xml version='1.0' encoding='UTF-8'?>
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
7
Process this file with an XSLT processor: `xsltproc \
8
-''-nonet /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/\
9
manpages/docbook.xsl manpage.dbk'. A manual page
10
<package>.<section> will be generated. You may view the
11
manual page with: nroff -man <package>.<section> | less'. A
12
typical entry in a Makefile or Makefile.am is:
14
DB2MAN=/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/\
18
manpage.1: manpage.dbk
21
The xsltproc binary is found in the xsltproc package. The
22
XSL files are in docbook-xsl. Please remember that if you
23
create the nroff version in one of the debian/rules file
24
targets (such as build), you will need to include xsltproc
25
and docbook-xsl in your Build-Depends control field.
29
<!-- Fill in your name for FIRSTNAME and SURNAME. -->
30
<!ENTITY dhfirstname "<firstname>Tim</firstname>">
31
<!ENTITY dhsurname "<surname>Dijkstra</surname>">
32
<!-- Please adjust the date whenever revising the manpage. -->
33
<!ENTITY dhdate "<date>juni 24, 2006</date>">
34
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are
35
allowed: see man(7), man(1). -->
36
<!ENTITY dhsection "<manvolnum>8</manvolnum>">
37
<!ENTITY dhemail "<email>tim@famdijkstra.org</email>">
38
<!ENTITY dhusername "Tim Dijkstra">
39
<!ENTITY dhucpackage "<refentrytitle>suspend-keygen</refentrytitle>">
40
<!ENTITY dhpackage "uswsusp">
41
<!ENTITY dhprogram "suspend-keygen">
42
<!ENTITY dhs2ram "s2ram">
43
<!ENTITY dhsuspend "s2disk">
44
<!ENTITY dhs2both "s2both">
45
<!ENTITY dhresume "resume">
46
<!ENTITY dhconfig "uswsusp.conf">
49
<!ENTITY debian "<productname>Debian</productname>">
50
<!ENTITY gnu "<acronym>GNU</acronym>">
51
<!ENTITY gpl "&gnu; <acronym>GPL</acronym>">
65
<holder>&dhusername;</holder>
75
<refname>&dhprogram;</refname>
77
<refpurpose>program to generate a RSA key to be used by &dhsuspend;</refpurpose>
82
<command>&dhprogram;</command>
88
<title>DESCRIPTION</title>
90
<para>This manual page documents briefly the
91
<command>&dhprogram;</command> command.</para>
93
<para>This manual page was written for the &debian; distribution
94
because the original program does not have a manual page.</para>
96
<para><command>&dhprogram;</command> is a program that will
97
generate a RSA key which can be used by the <command>&dhsuspend;</command>
98
to encrypt the image written to disk.
99
The program does not take any options, but will ask to give the size
100
of the key in bits and to supply a passphrase. You will
101
have to enter this passphrase on <command>&dhresume;</command>
102
to decrypt the image.
105
<para>To start using encryption, you will have to point
106
the "RSA key file" option in &dhconfig;(8) to the file &dhprogram;
112
<title>SEE ALSO</title>
114
<para>&dhsuspend; (8)., &dhconfig; (8).</para>
117
For more information see
118
<citetitle>/usr/share/doc/&dhpackage;/README.Debian</citetitle></para>
121
<title>AUTHOR</title>
123
<para>This manual page was written by &dhusername; &dhemail; for
124
the &debian; system (but may be used by others). Permission is
125
granted to copy, distribute and/or modify this document under
126
the terms of the &gnu; General Public License, Version 2 any
127
later version published by the Free Software Foundation.
130
On Debian systems, the complete text of the GNU General Public
131
License can be found in /usr/share/common-licenses/GPL.