Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 

POSTQUEUE(1)                                                      POSTQUEUE(1)

NAME
       postqueue - Postfix queue control

SYNOPSIS
       postqueue [-v] [-c config_dir] -f
       postqueue [-v] [-c config_dir] -p
       postqueue [-v] [-c config_dir] -s site

DESCRIPTION
       The  postqueue(1)  command  implements  the  Postfix  user
       interface for queue management. It  implements  operations
       that  are traditionally available via the sendmail(1) com-
       mand.  See the postsuper(1) command for  queue  operations
       that require super-user privileges such as deleting a mes-
       sage from the queue or changing the status of a message.

       The following options are recognized:

       -c config_dir
              The main.cf configuration  file  is  in  the  named
              directory  instead  of  the  default  configuration
              directory. See  also  the  MAIL_CONFIG  environment
              setting below.

       -f     Flush  the  queue:  attempt  to  deliver all queued
              mail.

              This option implements  the  traditional  "sendmail
              -q" command, by contacting the Postfix qmgr(8) dae-
              mon.

              Warning:  flushing  undeliverable  mail  frequently
              will  result  in  poor  delivery performance of all
              other mail.

       -p     Produce a traditional sendmail-style queue listing.
              This  option  implements the traditional mailq com-
              mand, by contacting the Postfix showq(8) daemon.

              Each queue entry shows the queue file  ID,  message
              size, arrival time, sender, and the recipients that
              still need to be delivered.  If mail could  not  be
              delivered  upon  the  last  attempt, the reason for
              failure is shown. This mode of operation is  imple-
              mented  by  executing the postqueue(1) command. The
              queue ID string is followed by an  optional  status
              character:

              *      The message is in the active queue, i.e. the
                     message is selected for delivery.

              !      The message is in the hold  queue,  i.e.  no
                     further  delivery attempt will be made until
                     the mail is taken off hold.

       -s site
              Schedule immediate delivery of  all  mail  that  is
              queued for the named site. A numerical site must be
              specified as  a  valid  RFC  2821  address  literal
              enclosed  in [], just like in email addresses.  The
              site must be eligible for the "fast flush" service.
              See  flush(8)  for more information about the "fast
              flush" service.

              This option implements  the  traditional  "sendmail
              -qRsite"   command,   by   contacting  the  Postfix
              flush(8) daemon.

       -v     Enable verbose logging for debugging purposes. Mul-
              tiple  -v  options  make  the software increasingly
              verbose. As of Postfix 2.3, this option  is  avail-
              able for the super-user only.

SECURITY
       This  program  is designed to run with set-group ID privi-
       leges, so that it can connect to Postfix daemon processes.

DIAGNOSTICS
       Problems  are  logged  to  syslogd(8)  and to the standard
       error stream.

ENVIRONMENT
       MAIL_CONFIG
              Directory with the main.cf file. In order to  avoid
              exploitation  of  set-group  ID  privileges, a non-
              standard directory is allowed only if:

              o      The name is listed in the  standard  main.cf
                     file  with  the alternate_config_directories
                     configuration parameter.

              o      The command is invoked by the super-user.

CONFIGURATION PARAMETERS
       The following main.cf parameters are  especially  relevant
       to this program.  The text below provides only a parameter
       summary. See postconf(5) for more details including  exam-
       ples.

       alternate_config_directories (empty)
              A  list of non-default Postfix configuration direc-
              tories that may be specified with "-c config_direc-
              tory"  on  the command line, or via the MAIL_CONFIG
              environment parameter.

       config_directory (see 'postconf -d' output)
              The default location of  the  Postfix  main.cf  and
              master.cf configuration files.

       command_directory (see 'postconf -d' output)
              The  location  of  all  postfix administrative com-
              mands.

       fast_flush_domains ($relay_domains)
              Optional list of destinations that are eligible for
              per-destination  logfiles  with mail that is queued
              to those destinations.

       import_environment (see 'postconf -d' output)
              The list of environment parameters that  a  Postfix
              process  will  import  from  a  non-Postfix  parent
              process.

       queue_directory (see 'postconf -d' output)
              The location of the Postfix top-level queue  direc-
              tory.

       syslog_facility (mail)
              The syslog facility of Postfix logging.

       syslog_name (postfix)
              The  mail  system  name  that  is  prepended to the
              process name in syslog  records,  so  that  "smtpd"
              becomes, for example, "postfix/smtpd".

       trigger_timeout (10s)
              The  time  limit for sending a trigger to a Postfix
              daemon (for example, the pickup(8) or qmgr(8)  dae-
              mon).

       Available in Postfix version 2.2 and later:

       authorized_flush_users (static:anyone)
              List  of  users  who  are  authorized  to flush the
              queue.

       authorized_mailq_users (static:anyone)
              List of users who are authorized to view the queue.

FILES
       /var/spool/postfix, mail queue

SEE ALSO
       qmgr(8), queue manager
       showq(8), list mail queue
       flush(8), fast flush service
       sendmail(1), Sendmail-compatible user interface
       postsuper(1), privileged queue operations

README FILES
       ETRN_README, Postfix ETRN howto

LICENSE
       The Secure Mailer license must be  distributed  with  this
       software.

HISTORY
       The  postqueue command was introduced with Postfix version
       1.1.

AUTHOR(S)
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

                                                                  POSTQUEUE(1)