aboutsummaryrefslogtreecommitdiffstats
path: root/man/lpass.1
blob: 81d4237d264e926b53f9bfb423426a03df186e75 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
.TH "LPASS" "1" "1\ \&MARCH\ \&2021" "LPASS v1.1a" "LockPassword"

.SH "NAME"
LockPassword - a password manager.

.SH "SYNOPSIS"
\fBlpass\fR [command] [options]

.SH "DESCRIPTION"
\fBlpass\fR - a simple terminal password manager, using GnuPG to encrypt passwords.

.SH "COMMANDS"
\fBinit \fIgpg-key\fR
.RS 4
Initialize the password manager using the passed \fIgpg-key\fR as the encryption key. This command must be run first before you start working with LockPassword.
.RE
.PP

\fBinsert\fR [-e, --echo] [-c, --copy] [-f, --force] \fIpassname\fR
.RS 4
Add the specified \fIpassname\fR to the password manager. The password will be read interactively using standard input, character display is hidden. The \fB-e, --echo\fR argument enable the show of characters when typing a password; \fB-c, --copy\fR write password to clipboard; \fB-f, --force\fR ignore exist of \fIpassname\fR, overwrites it without prompt.
.RE
.PP

\fBgenerate\fR [-l, --length=pass-length] [-c, --copy] [-f, --force] \fIpassname\fR
.RS 4
Generate a random password and write it in \fIpassname\fR. The \fB-l, --length = pass-length\fR argument allow you to specify the desired password length. Without this argument, a 14 character password will be generated. \fB-c, --copy\fR write password to clipboard; \fB-f, --force\fR ignore exist of \fIpassname\fR, overwrites it without prompt.
.RE
.PP

\fBmv\fR [-f, --force] \fIold-path new-path\fR
.RS 4
Move/rename \fIold-path\fR to \fInew-path\fR. \fIold-path\fR must be an exist file, \fInew-path\fR can be a file/directory. The \fB-f, --force\fR argument ignore exist of \fInew-path\fR (if it's a file), overwrites it without prompt.
.RE
.PP

\fBrm \fIpassname\fR
.RS 4
Remove the \fIpassname\fR you specified from the password manager. If the directories where your \fIpassname\fR was nested became empty after deletion, then they are also deleted.
.RE
.PP

\fBhelp\fR
.RS 4
Print help information about commands and the application itself.
.RE
.PP

\fBversion\fR
.RS 4
Print information about the version, release date, and license of the application.
.RE
.PP

.SH "EXAMPLES"
Initialize the password manager:
.RS 4
\fB$ lpass init joursoir@joursoir.net\fR
.br
LockPassword initialized for joursoir@joursoir.net
.br
.RE
.PP

Add password in the password manager:
.RS 4
\fB$ lpass insert games/chess/user\fR
.br
Please type your new password: [invisible input]
.br
Please type your new password again: [invisible input]
.br
Password added successfully for games/chess/user
.RE
.PP

Print a list of exists password:
.RS 4
\fB$ lpass\fR
.br
Password Manager
.br
|-- banks
.br
|   |-- abankpro
.br
|   |   `-- phone_number
.br
|   `-- ubank
.br
|       `-- phone_number
.br
`-- games
.br
    `-- chess
.br
        |-- site.com
.br
        `-- user
.RE
.PP

Print a list of exists password in some directory:
.RS 4
\fB$ lpass banks\fR
.br
Password Manager/banks
.br
|-- abankpro
.br
|   `-- phone_number
.br
`-- ubank
.br
    `-- phone_number
.RE
.PP

Show password:
.RS 4
\fB$ lpass games/iko/LordOfNight\fR
.br
helloitismypassword123
.RE
.PP

Copy password to clipboard:
.RS 4
\fB$ lpass -c games/iko/LordOfNight
.RE
.PP

Generate password:
.RS 4
\fB$ lpass generate bank/sbank/phone_number\fR
.br
Generated password: NsNu:+^Re(cshW
.br
Password added successfully for bank/sbank/phone_number
.RE
.PP

.SH "COPYING"
Copyright (C) 2020-2021 Aleksandr D. Goncharov (Joursoir)
.br
License: GNU GPL version 3
.br
This is free software: you are free to change and redistribute it. This program comes with ABSOLUTELY NO WARRANTY.