~ubuntu-branches/ubuntu/trusty/systemd/trusty

'\" t

.\"     Title: systemd-cryptsetup-generator

.\"    Author: Lennart Poettering <lennart@poettering.net>

.\" Generator: DocBook XSL Stylesheets v1.77.1 <http://docbook.sf.net/>

.\"      Date: 03/07/2013

.\"    Manual: systemd-cryptsetup-generator

.\"    Source: systemd

.\"  Language: English

.\"

.TH "SYSTEMD\-CRYPTSETUP\" "8" "" "systemd" "systemd-cryptsetup-generator"

.\" -----------------------------------------------------------------

.\" * Define some portability stuff

.\" -----------------------------------------------------------------

.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.\" http://bugs.debian.org/507673

.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html

.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.ie \n(.g .ds Aq \(aq

.el       .ds Aq '

.\" -----------------------------------------------------------------

.\" * set default formatting

.\" -----------------------------------------------------------------

.\" disable hyphenation

.nh

.\" disable justification (adjust text to left margin only)

.ad l

.\" -----------------------------------------------------------------

.\" * MAIN CONTENT STARTS HERE *

.\" -----------------------------------------------------------------

.SH "NAME"

systemd-cryptsetup-generator \- Unit generator for /etc/crypttab

.SH "SYNOPSIS"

.PP

/usr/lib/systemd/system\-generators/systemd\-cryptsetup\-generator

.SH "DESCRIPTION"

.PP

systemd\-cryptsetup\-generator

is a generator that translates

/etc/crypttab

into native systemd units early at boot and when configuration of the system manager is reloaded\&. This will create

\fBsystemd-cryptsetup@.service\fR(8)

units as necessary\&.

.PP

systemd\-cryptsetup\-generator

implements the

\m[blue]\fBgenerator specification\fR\m[]\&\s-2\u[1]\d\s+2\&.

.SH "KERNEL COMMAND LINE"

.PP

systemd\-cryptsetup\-generator

understands the following kernel command line parameters:

.PP

\fIluks=\fR, \fIrd\&.luks=\fR

.RS 4

Takes a boolean argument\&. Defaults to

yes\&. If

no

disables the generator entirely\&.

\fIrd\&.luks=\fR

is honored only by initial RAM disk (initrd) while

\fIluks=\fR

is honored by both the main system and the initrd\&.

.RE

.PP

\fIluks\&.crypttab=\fR, \fIrd\&.luks\&.crypttab=\fR

.RS 4

Takes a boolean argument\&. Defaults to

yes\&. If

no

causes the generator to ignore any devices configured in

/etc/crypttab

(\fIluks\&.uuid=\fR

will still work however)\&.

\fIrd\&.luks\&.crypttab=\fR

is honored only by initial RAM disk (initrd) while

\fIluks\&.crypttab=\fR

is honored by both the main system and the initrd\&.

.RE

.PP

\fIluks\&.uuid=\fR, \fIrd\&.luks\&.uuid=\fR

.RS 4

Takes a LUKS super block UUID as argument\&. This will activate the specified device as part of the boot process as if it was listed in

/etc/fstab\&. This option may be specified more than once in order to set up multiple devices\&.

\fIrd\&.luks\&.uuid=\fR

is honored only by initial RAM disk (initrd) while

\fIluks\&.uuid=\fR

is honored by both the main system and the initrd\&.

.RE

.SH "SEE ALSO"

.PP

 

\fBsystemd\fR(1),

\fBcrypttab\fR(5),

\fBsystemd-cryptsetup@.service\fR(8),

\fBcryptsetup\fR(8),

\fBsystemd-fstab-generator\fR(8)

.SH "NOTES"

.IP " 1." 4

generator specification

.RS 4

\%http://www.freedesktop.org/wiki/Software/systemd/Generators

.RE