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)

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

home | help