Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
pass-update(1)		     General Commands Manual		  pass-update(1)

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  automati-
     cally generating new passwords or manually setting your own.

     pass  update  assumes that the first line of the password file is the pass-
     word 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 op-
     tions.

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 up-
	    dating 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 speci-
	    fied, 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.  Be-
	    ware  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]+$' /

SEE ALSO
     pass(1), pass-tomb(1), pass-import(1), pass-otp(1), pass-audit(1)

AUTHORS
     pass update was written by Alexandre Pujol.

COPYING
     This program is free software: you can redistribute it and/or modify it un-
     der 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  FIT-
     NESS 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/>.

pass-update			  December 2018 		  pass-update(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pass-update&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help