postkick(1)

postkick1

Kick a postfix service

Usage

postkick [-c config_dir] [-v] class service request

Overview

The postkick(1) command sends request to the specified service over a local transport channel. This command makes Postfix private IPC accessible for use in, for example, shell scripts.

Options:

-c config_dir

Read the main.cf configuration file in the named directory instead of the default configuration directory.

-v

Enable verbose logging for debugging purposes. Multiple -v options make the software increasingly verbose.

Arguments:

class

Name of a class of local transport channel endpoints, either public (accessible by any local user) or private (administrative access only).

service

The name of a local transport endpoint within the named class.

request

A string. The list of valid requests is service-specific.

Diagnostics

Problems and transactions are logged to the standard error stream.

Environment


    

    
        
MAIL_CONFIG

Directory with Postfix configuration files.

MAIL_VERBOSE

Enable verbose logging for debugging purposes.

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

config_directory (see 'postconf -d' output)

The default location of the Postfix main.cf and master.cf configuration files.

application_event_drain_time (100s)

How long the postkick(1) command waits for a request to enter the Postfix daemon process input buffer before giving up.

import_environment (see 'postconf -d' output)

The list of environment variables that a privileged Postfix process will import from a non-Postfix parent process, or name=value environment overrides.

queue_directory (see 'postconf -d' output)

The location of the Postfix top-level queue directory.

Files

/var/spool/postfix/private, private class endpoints
/var/spool/postfix/public, public class endpoints

Author(s)

Wietse Venema
IBM T.J. Watson Research
P.O. Box 704
Yorktown Heights, NY 10598, USA
Wietse Venema
Google, Inc.
111 8th Avenue
New York, NY 10011, USA

Releases

14 releases since Debian 2.2 (Potato); the text changed 7 times.

  1. 2.2
  2. 3.0
  3. 3.1
  4. 4.0–6.0
  5. 7–8
  6. 9
  7. 10–12
  8. 13–Arch

License


    

    
        

The Secure Mailer license must be distributed with this software.

From postfix 3.11.7-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.