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

FreeBSD Manual Pages

  
 
  

home | help
qconfirm(1)		    General Commands Manual		   qconfirm(1)

NAME
       qconfirm	- manage addresses/ids in a qconfirm directory

SYNOPSIS
       qconfirm	[-iC] [-d dir] [-c cdb]	list [pending|ok|return|bad]

       qconfirm	[-iCD] [-d dir]	[-c cdb] arg addresses

DESCRIPTION
       qconfirm	 either	 lists pending,	known, bouncing, or bad	addresses in a
       qconfirm	directory, or alters their states  to  tell  qconfirm-check(1)
       what to do with mails from these	addresses.

       arg  is	either check, accept, drop, bounce, sneak, pending, remove, or
       bad.  addresses consists	of one or more mail addresses or qconfirm ids.

ARGS
       list   lists all	ids in the pending/, ok/, return/, or  bad/  directory
	      as mail addresses, one per line. Each address is preceded	with a
	      time-stamp indicating when the  last  confirmation  request  was
	      sent (pending/), when the	last message from this address was ac-
	      cepted (ok/), when the most  recent  bounce  was	received  (re-
	      turn/), or when the id was created (bad/).  If neither the pend-
	      ing, ok, return, or bad option  is  given,  qconfirm  lists  the
	      pending directory	and appends to each address its	current	state.

       check  check  for each mail address in addresses	its state in the qcon-
	      firm directory.  The state can be	either known,  unknown,	 pend-
	      ing, or bad.

       accept alter  the state for each	mail address in	addresses to known. If
	      the state	of the mail address is pending,	this address  is  con-
	      firmed  manually.	The next time qmail tries to deliver a message
	      from this	address, the message is	 accepted  and	the  state  is
	      changed to known.

       drop   check  for  each	mail  address in addresses if the address cur-
	      rently is	pending.  If yes, tell qconfirm-check(1)  to  silently
	      drop  the	message	the next time qmail tries to deliver a message
	      from this	address.

       bounce check for	each mail address in addresses	if  the	 address  cur-
	      rently is	pending.  If yes, tell qconfirm-check(1) to bounce the
	      message the next time qmail tries	to deliver a message from this
	      address.

       sneak  check  for  each	mail  address in addresses if the address cur-
	      rently is	pending.  If yes, tell qconfirm-check(1) to forward  a
	      preview  of a message from this address to $QCONTROL_OWNER.  Af-
	      ter the preview is sent, qconfirm-check(1)  switches  the	 state
	      back to pending.

       pending
	      switch the state of each mail address back to pending.

       remove check  for  each	mail  address  in  addresses if	the address is
	      known.  If yes, change its state to unknown.  Note: If  qconfirm
	      updates  the constant database cdb, it creates cdb.tmp as	tempo-
	      rary file.  If cdb.tmp exists, it	will be	destroyed.

       bad    check for	each mail address in addresses if the address  is  un-
	      known or pending.	 If yes, tell qconfirm-check(1)	to permanently
	      bounce messages from this	address.

OPTIONS
       -i     id.  Force all addresses to be interpreted as qconfirm ids,  not
	      mail  addresses,	and  output  qconfirm  ids instead of mail ad-
	      dresses.

       -C     cdb.  Additionally to the	qconfirm directory, check the  default
	      constant database	for known ids (``~/.qconfirm/ok.cdb'').

       -d dir Override	the  default  qconfirm directory (``~/.qconfirm'') and
	      the environment variable QCONFIRM_DIR with dir.

       -c cdb Set the filename of the constant database	to be checked to  cdb.
	      Default  is ``ok.cdb'' (in the qconfirm directory).  This	option
	      also overrides the environment variable QCONFIRM_OKCDB, and  the
	      configuration  file QCONFIRM_OKCDB.  If cdb doesn't start	with a
	      slash, it	is searched in the user's  qconfirm  directory.	  This
	      option implies the -C option.

       -D     Don't use	extended envelope sender domain	matching when checking
	      ids.

CONFIGURATION
       qconfirm	reads its configuration	from files in the  subdirectory	 conf/
       of  the	qconfirm directory (normally ``~/.qconfirm/conf/'').  Only the
       first line of a configuration file is considered.

       QCONFIRM_OKCDB
	      The configuration	file QCONFIRM_OKCDB overrides the default name
	      of the user's constant database for known	ids (``ok.cdb'').

ENVIRONMENT
       QCONFIRM_DIR
	      The  environment variable	QCONFIRM_DIR overrides the default lo-
	      cation of	the user's qconfirm directory (``~/.qconfirm'').

       QCONFIRM_OKCDB
	      The environment variable QCONFIRM_OKCDB  overrides  the  default
	      name of the user's constant database for known ids (``ok.cdb''),
	      and the configuration file  QCONFIRM_OKCDB.   If	QCONFIRM_OKCDB
	      doesn't  start  with a slash, it is searched in the user's qcon-
	      firm directory.

SEE ALSO
       qconfirm-check(1), qconfirm-conf(1),  qconfirm-inject(1),  qconfirm-no-
       tice(1),	 qconfirm-accept(1),  qconfirm-return(1), qconfirm-control(1),
       qconfirm-cdb-check(1), qconfirm-cdb-update(1)

       http://smarden.org/qconfirm/

AUTHOR
       Gerrit Pape <pape@smarden.org>

								   qconfirm(1)

NAME | SYNOPSIS | DESCRIPTION | ARGS | OPTIONS | CONFIGURATION | ENVIRONMENT | SEE ALSO | AUTHOR

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

home | help