make-jpkg.1 4.35 KB
Newer Older
1 2 3 4
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
5
.TH MAKE-JPKG 1 "September 10, 2016"
6 7 8 9 10 11 12 13 14 15 16 17 18
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
19
make-jpkg \- builds Debian packages from Java binary distributions
20 21 22 23 24
.SH SYNOPSIS
.B make-jpkg
[\fIOPTION\fR]... [\fIFILE\fR]
.SH DESCRIPTION
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
Emmanuel Bourg's avatar
Emmanuel Bourg committed
25
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
26 27
.\" respectively.
.PP
28
\fBmake-jpkg\fP builds a Debian package from the given Java
29
distribution FILE.
30 31 32
.PP
Supported java binary distributions currently include:
  * Oracle (http://www.oracle.com/technetwork/java/javase/downloads) :
33 34 35
    - The Java Development Kit (JDK), version 6, 7 and 8
    - The Java Runtime Environment (JRE), version 6, 7 and 8
    - The Java API Javadoc, version 6, 7 and 8
36
  (Choose tar.gz archives or self-extracting archives, do _not_ choose the RPM!)
37 38 39 40 41 42 43 44 45
.PP
The following options are recognized:
.TP
.B --full-name \fINAME\fR
full name used in the maintainer field of the package
.TP
.B --email \fIEMAIL\fR
email address used in the maintainer field of the package
.TP
46 47 48
.B --distribution \fIDISTRIBUTION\fR
distribution to use in the debian changelog for the resulting package
.TP
49 50 51 52 53 54
.B --priority \fIPRIORITY\fR
numeric priority for use by \fBupdate-alternatives\fP.  This overrides the default
priority, which is intentionally lower than that of the Debian-provided OpenJDK
packages.  Only use this option if the generated package should be considered higher
priority by \fBupdate-alternatives\fP.
.TP
55 56 57 58 59 60
.B --changes
create a .changes file
.TP
.B --revision
add debian revision
.TP
61 62 63
.B --source
build a source package instead of a binary deb package
.TP
64 65 66 67 68
.B --with-system-certs
Replace the JVMs keystore with a softlink to the system's keystore,
(/etc/ssl/certs/java/cacerts) which is managed automatically by the
ca-certificates and ca-certificates-java packages.
.TP
69 70 71
.B --jce-policy \fIJCE_POLICY_FILE\fR
Replace cryptography files with versions
from the specified JCE_POLICY_FILE.
Tony Mancill's avatar
Tony Mancill committed
72
.TP
73 74 75 76 77 78
.B --help
display help text and exit
.TP
.B --version
output version information and exit
.PP
79
Download a supported JRE, JDK, API tar.gz or self-extracting archive from
80 81 82 83 84
.B http://www.oracle.com/technetwork/java/javase/downloads
and execute
.B make-jpkg
.I file
with the downloaded file. The program asks the user for additional
85
information and builds a Debian binary package in the current
86 87
directory.
.PP
88
The program requires about 400 MB free disk space in a temporary
Emmanuel Bourg's avatar
Emmanuel Bourg committed
89
directory. The temporary directory defaults to
90 91 92
.I /tmp
but you can specify an alternate directory by setting the environment
variable \fITMPDIR\fR.
93
.SH EXAMPLE
94
To install Oracle(TM) 8 Standard Edition JDK, download a release from http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html and invoke make-jpkg, for example:
95
.IP
96
make-jpkg <path_to_download_directory>/jdk-8u102-linux-x64.tar.gz
97 98 99
.PP
This generate a Debian package in the current directory, that can be installed using dpkg:
.IP
100
dpkg \-i oracle-java8-jdk_8u102_amd64.deb
101
.PP
102
When you're done, you can delete initial download as well as generated package:
103
.IP
104
rm <path_to_download_directory>/jdk-8u102-linux-x64.tar.gz oracle-java8-jdk_8u102_amd64.deb
105
.PP
106 107 108 109 110 111 112 113 114 115 116 117
.SH ENVIRONMENT
.TP
.SM TMPDIR
base directory used for temporary files (defaults to /tmp)
.TP
.SM J2SE_PACKAGE_FULL_NAME
full name used in the maintainer field of the package; if none is supplied
then the default of "Debian Java Maintainers" is used.
.TP
.SM J2SE_PACKAGE_EMAIL
email address used in the maintainer field of the package; if none is supplied
the default of "pkg-java-maintainers@lists.alioth.debian.org" is used.
118 119
.SH SEE ALSO
.BR update-java-alternatives(1)
120 121 122 123
.SH AUTHOR
This manual page was written by Hubert Schmid <j2se-package@z42.de>.

It is now maintained by the Debian Java Maintainers <pkg-java-maintainers@lists.alioth.debian.org>.