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)

NAME | SYNOPSIS | DESCRIPTION | COMMAND | OPTIONS | EXAMPLES | SEE ALSO | AUTHORS | COPYING

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

home | help