NAME

pass-update - A pass(1) extension that provides an easy flow for updating passwords.

SYNOPSIS

pass update [options] pass-names...

DESCRIPTION

pass update extends the pass utility with an update command providing an easy flow for updating passwords. It supports path, directory and wildcard update. Moreover, you can select how to update your passwords by automatically generating new passwords or manually setting your own.

pass update assumes that the first line of the password file is the password and so only ever updates the first line unless the --multiline option is specified.

By default pass update prints the old password and wait for the user before generating a new one. This behaviour can be changed using the provided options.

COMMAND

pass update [ --clip, -c ] [ --no-symbols, -n ] [ --provide, -p ] [--length=<size>, -l <size>]

[ --include=<regex>, -i <regex> ] [ --exclude=<regex>, -e=<regex> ] [ --edit, -E ] [ --multiline, -m ] pass-names...

Update the password provided: print the password and wait for the user to generate a new one.

pass-names can refer either to password store path(s) or directory. Both path and directory can be given in the same command. When updating a directory, all the passwords in this directory are updated. Wildcard update is supported by quoting '*' sign.

Both old and newly generated password can optionally be written on the clipboard using the --clip or -c option.

If --no-symbols or -n is specified, do not use any non-alphanumeric characters in the generated password.

Specific password length can be given using --length or -l is specified, along with a numerical argument.

If --provide or -p is specified, let the user specify a password by hand. The user will have to confirm the password.

If --multiline or -m is specified, update a multiline password. Beware this option will overwrite the full password file instead of updating the password field.

If --include or -i is specified, Only update the passwords that match a given regex.

If --exclude or -e is specified, Do not update the passwords that match a given regex.

If --edit or -E is specified, edit the password using the default editor. This editor can be specified with EDITOR.

If --force or -f is specified, pass update does not wait for the user and generate a new password immediately.

OPTIONS

-c, --clip

Write the password in the clipboard.

-n, --no-symbols

Do not use any non-alphanumeric characters.

-l <size>, --length=<size>

Provide a password length.

-p, --provide

Let the user specify a password by hand.

-m, --multiline

Update a multiline password.

-e <regex>, --exclude=<regex>

Do not update the passwords that macth a regex.

-i <regex>, --include=<regex>

Only update the passwords that match a regex.

-E, --edit

Edit the password using the default editor.

-f, --force

Force to update and do not wait for user instruction.

-V, --version

Show version information

-h, --help

Show usage message.

EXAMPLES

Update Social/twitter.com

zx2c4@laptop ~ $ pass update Social/twitter.com
Changing password for Social/twitter.com
[}p&62"#"x'aF/_ix}6X3a)zq
Are you ready to generate a new password? [y/N] y
The generated password for Social/twitter.com is:
~*>afZsB+Gc#+g$-,{OqJ{w

Update all the Emails

zx2c4@laptop ~ $ pass update Email
Changing password for Email/donenfeld.com
b9b"k(u#m7|ST-400B5gM%[Kq
Are you ready to generate a new password? [y/N] y
The generated password for Email/donenfeld.com is:
m6~!b5U`OhloT~R,4-OCa:h$Q
Changing password for Email/zx2c4.com
4Fg{1Wg;WM{JZHqAMI:j5Jo$7
Are you ready to generate a new password? [y/N] y
The generated password for Email/zx2c4.com is:
@uLYW_X9a",?wDQN=hp/^Z!$J

Set password length

zx2c4@laptop ~ $ pass update France/bank -l 50
Changing password for France/bank
9b'I;]b)>06xug!3.ME1*E+M3
login: zx2c4
Are you ready to generate a new password? [y/N] y
The generated password for France/bank is:
|3=&{ko:#I|A,P4*=[|hk^/V4jIcRN.uBBd-~RB0_L<sS[%k%-

Provide a password by hand

zx2c4@laptop ~ $ pass update Business/site.com -p
Changing password for Business/site.com
Zk=u]HqjUAKPZ$gM_,LuZV8J2
login: zx2c4
Are you ready to provide a new password? [y/N] y
Enter the new password for Business/site.com:
Retype the new password for Business/site.com:

Do not update PIN code

zx2c4@laptop ~ $ pass update --exclude '^[0-9]+$' /

Update only PIN code

zx2c4@laptop ~ $ pass update --include '^[0-9]+$' /

AUTHORS

pass update was written by Alexandre Pujol.

COPYING

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.