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

FreeBSD Manual Pages

  
 
  

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

NAME
       pass-update - A pass(1) extension that provides an easy flow for	updat-
       ing 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	direc-
	      tory. 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-alphanu-
	      meric 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  de-
	      fault 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 <alexandre@pujol.io>.

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  MER-
       CHANTABILITY  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/>.

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.0>

home | help