$ postqueue

Söz Dizimi

   Posta kuyruğunu boşaltmak (flush) için:

       postqueue [-v] [-c config_dir] -f

       postqueue [-v] [-c config_dir] -i queue_id

       postqueue [-v] [-c config_dir] -s site

   Posta kuyruğunu listelemek için:

       postqueue [-v] [-c config_dir] -j

       postqueue [-v] [-c config_dir] -p

Açıklama

postqueue(1) komutu, kuyruk yönetimi için Postfix kullanıcı arayüzünü uygular. Geleneksel olarak sendmail(1) komutu aracılığıyla sunulan işlemleri gerçekleştirir. Kuyruktan bir iletiyi silmek veya bir iletinin durumunu değiştirmek gibi süper kullanıcı yetkileri gerektiren kuyruk işlemleri için postsuper(1) komutuna bakın.

Aşağıdaki seçenekler tanınır:

-c config_dir main.cf yapılandırma dosyası, varsayılan yapılandırma dizini yerine belirtilen dizinde aranır. Ayrıca aşağıdaki MAIL_CONFIG ortam değişkeni ayarına da bakın.

• -f: Kuyruğu boşaltır: kuyruğa alınmış tüm postaları teslim etmeye çalışır.

Bu seçenek, Postfix qmgr(8) arka plan programı ile iletişim kurarak geleneksel "sendmail -q" komutunu uygular.

Uyarı: Teslim edilemeyen postaların sık sık boşaltılması, diğer tüm postaların teslimat performansının düşmesine neden olur.

-i queue_id Belirtilen kuyruk kimliğine (queue ID) sahip ertelenmiş postanın hemen teslim edilmesini zamanlar.

Bu seçenek, flush(8) sunucusu ile iletişim kurarak geleneksel sendmail -qI komutunu uygular.

Bu özellik Postfix 2.4 ve sonraki sürümlerde mevcuttur.

• -j: showq(8) arka plan programının çıktısına dayanarak JSON biçiminde bir kuyruk listesi oluşturur. Sonuç, her bir kuyruk dosyası için bir tane olmak üzere sıfır veya daha fazla JSON nesnesinden oluşan bir veri akışıdır. Basit akış ayrıştırıcılarını desteklemek için her nesneyi bir yeni satır karakteri takip eder. Detaylar için aşağıdaki "JSON Nesne Biçimi" bölümüne bakın.

Bu özellik Postfix 3.1 ve sonraki sürümlerde mevcuttur.

• -p: Geleneksel sendmail tarzı bir kuyruk listesi oluşturur. Bu seçenek, Postfix showq(8) arka plan programı ile iletişim kurarak geleneksel mailq komutunu uygular.

Her kuyruk girdisi; kuyruk dosyası kimliğini, ileti boyutunu, varış zamanını, göndereni ve hala teslim edilmesi gereken alıcıları gösterir. Son denemede posta teslim edilemediyse, başarısızlık nedeni gösterilir. Kuyruk kimliği (queue ID) dizesini isteğe bağlı bir durum karakteri takip eder:

•  İleti aktif kuyruktadır, yani ileti teslimat için seçilmiştir.

! İleti bekletme (hold) kuyruğundadır, yani posta bekletmeden çıkarılana kadar başka bir teslimat denemesi yapılmayacaktır.

-s site Belirtilen site için sıraya alınmış tüm postaların hemen teslim edilmesini zamanlar. Sayısal bir site, tıpkı e-posta adreslerinde olduğu gibi, [] içine alınmış geçerli bir RFC 5321 adres sabiti olarak belirtilmelidir. Site, "hızlı boşaltma" (fast flush) hizmeti için uygun olmalıdır. "Hızlı boşaltma" hizmeti hakkında daha fazla bilgi için flush(8) sayfasına bakın.

Bu seçenek, Postfix flush(8) arka plan programı ile iletişim kurarak geleneksel "sendmail -qRsite" komutunu uygular.

• -v: Hata ayıklama amacıyla ayrıntılı günlük kaydını etkinleştirir. Birden fazla -v seçeneği, yazılımın giderek daha ayrıntılı bilgi vermesini sağlar. Postfix 2.3 itibarıyla bu seçenek yalnızca süper kullanıcı için mevcuttur.

JSON Nesne Biçimi

Her JSON nesnesi bir kuyruk dosyasını temsil eder; tek bir metin satırı olarak yayınlanır ve ardından bir yeni satır karakteri gelir.

Aksi belirtilmedikçe nesne üyeleri dize (string) değerlerine sahiptir. Programlar burada listelenmeyen nesne üyelerini yok saymalıdır; üye listesinin zamanla büyümesi beklenmektedir.

queue_name İletinin bulunduğu kuyruğun adı. Posta kuyruğu listelenirken içeriğinin değişebileceğini unutmayın; bazı iletiler birden fazla kez görünebilir ve bazı iletiler kaçırılabilir.

queue_id Kuyruk dosyasının adı. "enable_long_queue_ids = true" olmadığı ve zaman monoton (monotonic) akmadığı sürece queue_id bir Postfix örneği içinde yeniden kullanılabilir. O durumda bile, queue_id'nin farklı Postfix örnekleri arasında benzersiz olması beklenmez. Benzersiz bir ad gerektiren yönetim araçları, queue_id değerini Postfix örneğinin myhostname ayarı ile birleştirmelidir.

arrival_time UNIX çağının (epoch) başlangıcından bu yana geçen saniye sayısı.

message_size İleti üstbilgisindeki ve gövdesindeki bayt sayısı. Bu sayı ileti zarfı (envelope) bilgilerini içermez. satır sonları da dahil olmak üzere SMTP aracılığıyla iletilecek yaklaşık bayt sayısına eşittir.

sender Zarf gönderen (envelope sender) adresi.

recipients Aşağıdaki üyelere sahip sıfır veya daha fazla nesne içeren bir dizi:

address Bir alıcı adresi.

delay_reason Varsa, gecikmeli teslimatın nedeni. Geciken alıcıların bir gecikme nedeni olmayabilir; örneğin teslimat devam ederken veya sistem nedeni kaydedemeden durdurulduğunda.

Güvenlik

Bu program, Postfix arka plan işlemleriyle bağlantı kurabilmesi için set-group ID (SGID) yetkileriyle çalışacak şekilde tasarlanmıştır.

Standartlar

RFC 7159 (JSON gösterimi)

Teşhisler

Sorunlar syslogd(8) programına ve standart hata akışına (stderr) günlüğe kaydedilir.

Ortam

MAIL_CONFIG main.cf dosyasının bulunduğu dizin. set-group ID yetkilerinin kötüye kullanılmasını önlemek amacıyla, standart olmayan bir dizine yalnızca aşağıdaki durumlarda izin verilir:

• Adın, standart main.cf dosyasında alternate_config_directories yapılandırma parametresi ile listelenmiş olması.

• Komutun süper kullanıcı tarafından yürütülmesi.

Yapılandırma Parametreleri

Aşağıdaki main.cf parametreleri özellikle bu programla ilgilidir. Aşağıdaki metin yalnızca bir parametre özeti sunar. Örnekler dahil daha fazla ayrıntı için postconf(5) sayfasına bakın.

alternate_config_directories (boş) Komut satırında "-c config_directory" (sendmail(1) durumunda "-C config_directory") ile veya MAIL_CONFIG ortam değişkeni aracılığıyla belirtilebilen, varsayılan olmayan Postfix yapılandırma dizinlerinin bir listesi.

config_directory ('postconf -d' çıktısına bakın) Postfix main.cf ve master.cf yapılandırma dosyalarının varsayılan konumu.

command_directory ('postconf -d' çıktısına bakın) Tüm postfix yönetim komutlarının konumu.

fast_flush_domains ($relay_domains) Bu hedeflere sıraya alınmış postalarla birlikte, hedef başına günlük dosyaları (per-destination logfiles) için uygun olan isteğe bağlı hedefler listesi.

import_environment ('postconf -d' çıktısına bakın) Bir Postfix işleminin, Postfix olmayan bir üst (parent) işlemden içe aktaracağı ortam değişkenlerinin listesi.

queue_directory ('postconf -d' çıktısına bakın) Postfix üst düzey kuyruk dizininin konumu.

syslog_facility (mail) Postfix günlük kaydının syslog olanağı (facility).

syslog_name ('postconf -d' çıktısına bakın) syslog kayıtlarında işlem adının önüne eklenen bir önek; böylece, örneğin "smtpd", "prefix/smtpd" haline gelir.

trigger_timeout (10s) Bir Postfix arka plan programına (örneğin pickup(8) veya qmgr(8) programı) bir tetikleyici göndermek için zaman sınırı.

Postfix 2.2 ve sonraki sürümlerde mevcuttur:

authorized_flush_users (static:anyone) Kuyruğu boşaltmaya yetkili kullanıcıların listesi.

authorized_mailq_users (static:anyone) Kuyruğu görüntülemeye yetkili kullanıcıların listesi.

Dosyalar

/var/spool/postfix, posta kuyruğu

Ayrıca Bakınız

qmgr(8), kuyruk yöneticisi showq(8), posta kuyruğunu listele flush(8), hızlı boşaltma hizmeti sendmail(1), Sendmail uyumlu kullanıcı arayüzü postsuper(1), yetkili kuyruk işlemleri

Benioku Dosyaları

Bu bilgiyi bulmak için "postconf readme_directory" veya "postconf html_directory" komutlarını kullanın. ETRN_README, Postfix ETRN nasıl yapılır (howto) kılavuzu

Lisans

Secure Mailer lisansı bu yazılımla birlikte dağıtılmalıdır.

Tarihçe

postqueue komutu, Postfix 1.1 sürümü ile birlikte sunulmuştur.

Yazar(lar)

Wietse Venema IBM T.J. Watson Research P.O. Box 704 Yorktown Heights, NY 10598, ABD

Wietse Venema Google, Inc. 111 8th Avenue New York, NY 10011, ABD

POSTQUEUE(1)