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

FreeBSD Manual Pages

  
 
  

home | help
PASS-OTP(1)		    General Commands Manual		   PASS-OTP(1)

NAME
       pass-otp	- A pass(1) extension for managing one-time-password (OTP) to-
       kens.

SYNOPSIS
       pass otp	[ COMMAND ] [ OPTIONS ]... [ ARGS ]...

DESCRIPTION
       pass-otp	extends	the pass(1) utility with the otp  command  for	adding
       OTP secrets, generating OTP codes, and displaying secret	key URIs using
       the standard otpauth:// scheme.

       If no COMMAND is	specified, COMMAND defaults to code.

COMMANDS
       otp code	[ --clip, -c ] pass-name

	      Generate and print an OTP	code from the  secret  key  stored  in
	      pass-name	 using	oathtool(1).  If --clip	or -c is specified, do
	      not print	the code but instead copy it to	 the  clipboard	 using
	      xclip(1)	and  then  restore  the	 clipboard  after 45 (or PASS-
	      WORD_STORE_CLIP_TIME) seconds.  This  command  is	 alternatively
	      named show.

       otp  insert  [  --force,	-f ] [ --echo, -e ] [ [	--secret, -s ] [ --is-
       suer, -i	issuer ] [ --account, -a account ] ] [ pass-name ]

	      Prompt for and insert a new OTP secret into the  password	 store
	      at pass-name.

	      If  --secret is specified, prompt	for the	secret value, assuming
	      SHA1 algorithm, 30-second	period,	and 6 OTP digits. One or  both
	      of issuer	and account must also be specified.

	      If --secret is not specified, prompt for a key URI; see the doc-
	      umentation  at  <https://github.com/google/google-authenticator/
	      wiki/Key-Uri-Format> for the key URI specification.

	      The  secret is consumed from stdin; specify --echo or -e to echo
	      input when running this command interactively. If	 pass-name  is
	      not  specified,  convert	the  issuer:accountname	URI label to a
	      path in the form of isser/accountname. Prompt before overwriting
	      an existing secret, unless --force or -f is specified. This com-
	      mand is alternatively named add.

       otp append [ --force, -f	] [ --echo, -e ] [ [ --secret, -s  ]  [	 --is-
       suer, -i	issuer ] [ --account, -a account ] ] pass-name

	      Append  an  OTP secret to	the password stored in pass-name, pre-
	      serving any existing lines.

	      If --secret is specified,	prompt for the secret value,  assuming
	      SHA1  algorithm, 30-second period, and 6 OTP digits. One or both
	      of issuer	and account must also be specified.

	      If --secret is not specified, prompt for a key URI; see the doc-
	      umentation  at  <https://github.com/google/google-authenticator/
	      wiki/Key-Uri-Format> for the key URI specification.

	      The URI is consumed from stdin; specify --echo or	-e to echo in-
	      put when running this command interactively. Prompt before over-
	      writing an existing secret, unless --force or -f is specified.

       otp uri [ --clip, -c | --qrcode,	-q ] pass-name

	      Print the	key URI	stored in pass-name to stdout. If --clip or -c
	      is  specified,  do  not print the	URI but	instead	copy it	to the
	      clipboard	using xclip(1) and then	restore	the clipboard after 45
	      (or  PASSWORD_STORE_CLIP_TIME)  seconds.	If  --qrcode  or -q is
	      specified, do not	print the URI but instead display  a  QR  code
	      using  qrencode(1) either	to the terminal	or graphically if sup-
	      ported.

       otp validate uri

	      Test a URI string	for validity according to the Key Uri  Format.
	      For more information about this format, see the documentation at
	      <https://github.com/google/google-authenticator/wiki/Key-Uri-
	      Format>.

OPTIONS
       help, -h, --help
	      Show usage message.

SEE ALSO
       pass(1),	qrencode(1), zbarimg(1)

AUTHORS
       pass-otp	was written by Tad Fisher <tadfisher@gmail.com>.

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

Password store OTP extension	 2017 March 19			   PASS-OTP(1)

NAME | SYNOPSIS | DESCRIPTION | COMMANDS | OPTIONS | SEE ALSO | AUTHORS | COPYING

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

home | help