.\" Generated by scdoc 1.11.2
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "unl0kr" "1" "2023-12-21" "unl0kr"
.P
.SH NAME
.P
UNL0KR - LVGL based initramfs disk unlocker
.P
.SH SYNOPSIS
.P
unl0kr [OPTION]
.P
.SH DESCRIPTION
.P
UNL0KR is a disk unlocker for the initramfs based on LVGL.\& By using LVGL and
rendering directly to the framebuffer it can work without relying on GPU
hardware acceleration.\& This makes for much more managable initramfs sizes.\&
.P
Unl0kr utilises the CRYPTTAB_TRIED variable.\& Upon completion, the entered
password is printed to STDOUT.\& All other output happens on STDERR.\&
.P
.SH OPTIONS
.P
.SS Optional
.P
\fB-C, --config-override\fR
.RS 4
Path to a config override file.\& Can be supplied multiple times.\& Config 
files are merged in the following order:
.RS 4
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
/etc/unl0kr.\&conf
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
/etc/unl0kr.\&conf.\&d/* (alphabetically)
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
Override files (in supplied order)
.RE
.RE

.RE
\fB-g, --geometry=NxM[@X,Y]\fR
.RS 4
Force a display size of N horizontal times M vertical pixels, offset 
horizontally by X pixels and vertically by Y pixels.\&
.RE
\fB-d  --dpi=N\fR               
.RS 4
Override the display'\&s DPI value.\&
.RE
\fB-h, --help\fR                
.RS 4
Print this message and exit.\&
.RE
\fB-v, --verbose\fR             
.RS 4
Enable more detailed logging output on STDERR.\&
.RE
\fB-V, --version\fR             
.RS 4
Print the unl0kr version and exit.\&
.P
.RE
.SH EXAMPLES
.P
\fBDecrypt /dev/sda1 to name "root"\fR
.RS 4
CRYPTTAB_SOURCE="/dev/sda1" CRYPTTAB_TRIED="0" unl0kr | cryptsetup --perf-no_read_workqueue --perf-no_write_workqueue open "/dev/sda1" root -
.P
.RE
.SH SEE ALSO
.RS 4
\fBunl0kr.\&conf\fR(5)
.P
.RE
.SH AUTHORS
.P
\fBUndef\fR <debian@undef.\&tools>