X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=i3lock.1;h=8bc00f530a1bb518a3b28e50cb58d0735006ec63;hb=d4d589a7dd25a264c2679987fdb4072d833cb259;hp=31d88f164e3bfdab75613133521f0e7d502c4678;hpb=b4c10df0fc8440804d87e4df2f68a860b0bb08af;p=i3%2Fi3lock diff --git a/i3lock.1 b/i3lock.1 index 31d88f1..8bc00f5 100644 --- a/i3lock.1 +++ b/i3lock.1 @@ -8,10 +8,10 @@ .fi .. -.TH i3lock 1 "AUGUST 2009" Linux "User Manuals" +.TH i3lock 1 "JANUARY 2012" Linux "User Manuals" .SH NAME -i3lock \- slightly improved version of slock +i3lock \- improved screen locker .SH SYNOPSIS .B i3lock @@ -20,37 +20,34 @@ i3lock \- slightly improved version of slock .RB [\|\-b\|] .RB [\|\-d\|] .RB [\|\-i -.IR image.xpm \|] +.IR image.png \|] .RB [\|\-c .IR color \|] .RB [\|\-t\|] -.RP [\|\-p +.RB [\|\-p .IR pointer\|] +.RB [\|\-u\|] .SH DESCRIPTION .B i3lock -locks your screen by making it white (default). To quit -.B i3lock -just enter your password. +is a simple screen locker like slock. After starting it, you will see a white +screen (you can configure the color/an image). You can return to your screen by +entering your password. -.SH DIFFERENCES TO SLOCK +.SH IMPROVEMENTS -.B i3lock -improves slock by making it fork() and therefore combinable with -commands to suspend your computer. Additionally, instead of turning off -your screen via DPMS and/or displaying a black screen, -.B i3lock -displays a white (or colored in your favorite color) screen so you can see -if your computer failed to resume from suspend or if your screen is just -locked. Since version 1.1, -.B i3lock -can display images in XPM file format. Also, when entering a wrong password, -.B i3lock -does not call XBell(). This is important because -.B i3lock/slock -think you've entered a password when resuming from suspend, at least sometimes. +.TP +* i3lock forks, so you can combine it with an alias to suspend to RAM (run "i3lock && echo mem > /sys/power/state" to get a locked screen after waking up your computer from suspend to RAM) + +.TP +* You can specify either a background color or a PNG image which will be displayed while your screen is locked. + +.TP +* You can specify whether i3lock should bell upon a wrong password. + +.TP +* i3lock uses PAM and therefore is compatible with LDAP etc. -Since version 1.0, i3lock supports PAM. .SH OPTIONS .TP @@ -74,32 +71,40 @@ option, DPMS will turn off your screen after 15 minutes of inactivity anyways (i you did not disable this in your X server). .TP -.B \-i, \-\-image -Display the given XPM image instead of a blank screen. You can convert an image to -XPM by using convert(1) from ImageMagick or GIMP for example. +.B \-u, \-\-no-unlock-indicator +Disables the unlock indicator. i3lock will by default show an unlock indicator +after pressing keys. This will give feedback for every keypress and it will +show you the current PAM state (whether your password is currently being +verified or whether it is wrong). .TP -.B \-c, \-\-color +.BI \-i\ path \fR,\ \fB\-\-image= path +Display the given PNG image instead of a blank screen. + +.TP +.BI \-c\ rrggbb \fR,\ \fB\-\-color= rrggbb Turns the screen into the given color instead of white. Color must be given in 6-byte format: rrggbb (i.e. ff0000 is red) .TP -.B \-t, \-\-tile -If an image is specified (via -i) it will display the image tiled all over the screen +.B \-t, \-\-tiling +If an image is specified (via \-i) it will display the image tiled all over the screen (if it is a multi-monitor setup, the image is visible on all screens). .TP -.B \-p, \-\-pointer +.BI \-p\ win|default \fR,\ \fB\-\-pointer= win|default If you specify "default", .B i3lock -does not hide your Mousepointer.\n If you specify "win", +does not hide your Mousepointer. If you specify "win", .B i3lock displays a hardcoded Windows-Pointer (thus enabling you to fuck with your friends by using a Screenshot of a Windows-Desktop as a locking-screen). +.SH SEE ALSO +.IR xautolock(1) +\- use i3lock as your screen saver + .SH AUTHOR Michael Stapelberg Jan-Erik Rediger - -forked from slock-0.9 by Anselm R Garbe