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

FreeBSD Manual Pages

  
 
  

home | help
GPG-CHECK-PATTERN(1)	      GNU Privacy Guard 2.6	    GPG-CHECK-PATTERN(1)

NAME
     gpg-check-pattern - Check a passphrase on stdin against the patternfile

SYNOPSIS
     gpg-check-pattern [options] patternfile

DESCRIPTION
     gpg-check-pattern	checks	a  passphrase given on stdin against a specified
     pattern file.

     The pattern file is line based with comment lines beginning  on  the  first
     position  with  a	#.  Empty lines and lines with only white spaces are ig-
     nored.  The actual pattern lines may either be verbatim string pattern  and
     match as they are (trailing spaces are ignored) or extended regular expres-
     sions  indicated by a / or !/ in the first column and terminated by another
     / or end of line.	If a regular expression starts with !/ the match  result
     is reversed. By default all comparisons are case insensitive.

     Tag  lines  may be used to further control the operation of this tool.  The
     currently defined tags are:

     [icase]
	    Switch to case insensitive	comparison  for  all  further  patterns.
	    This is the default.

     [case]
	    Switch to case sensitive comparison for all further patterns.

     [reject]
	    Switch to reject mode.  This is the default mode.

     [accept]
	    Switch to accept mode.

     In  the  future more tags may be introduced and thus it is advisable not to
     start a plain pattern string with an open bracket.  The tags must be  given
     verbatim  on  the	line  with  no spaces to the left or any non white space
     characters to the right.

     In reject mode the program exits on the first match with an exit code of  1
     (failure).   If at the end of the pattern list the reject mode is still ac-
     tive the program exits with code 0 (success).

     In accept mode blocks of patterns are used.  A block  starts  at  the  next
     pattern  after  an  "accept"  tag and ends with the last pattern before the
     next "accept" or "reject" tag or at the end of the pattern  list.	 If  all
     patterns  in  a  block match the program exits with an exit code of 0 (suc-
     cess).  If any pattern in a block do not match the next  pattern  block  is
     evaluated.   If at the end of the pattern list the accept mode is still ac-
     tive the program exits with code 1 (failure).

OPTIONS
     --verbose
	    Enable extra informational output.

     --check
	    Run only a syntax check on the patternfile.

     --null
	    Input is expected to be null delimited.

SEE ALSO
     gpg-agent(1),

     The full documentation for this tool is maintained as a Texinfo manual.  If
     GnuPG and the info program are properly installed at your site, the command

       info gnupg

     should give you access to the complete manual including  a  menu  structure
     and an index.

GnuPG 2.5.18			   2026-06-12		    GPG-CHECK-PATTERN(1)

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

home | help