Sözdizimi
postmap [-NbfhimnoprsuUvw] [-c config_dir] [-d key] [-q key]
[file_type:]file_name ...Açıklama
postmap(1) komutu, bir veya daha fazla Postfix arama tablosu oluşturur, sorgular veya mevcut bir tabloyu günceller. Girdi ve çıktı dosya biçimlerinin şununla uyumlu olması beklenir:
makemap file_type file_name < file_name
Sonuç dosyaları mevcut değilse, kaynak dosyaları ile aynı grup ve diğer okuma izinlerine sahip olacak şekilde oluşturulurlar.
Tablo güncellemesi devam ederken, izleyici süreçlerde beklenmedik durumlerin önüne geçmek amacıyla sinyal teslimi ertelenir ve tablonun tamamı üzerinde özel, tavsiye niteliğinde (advisory) bir kilit uygulanır.
Girdi Dosyası Biçimi
Arama tablosu girdi dosyasının biçimi aşağıdaki gibidir:
• Bir tablo girdisi şu şekildedir:
anahtar boşluk değer
• Boş satırlar ve yalnızca boşluk karakterlerinden oluşan satırlar ile ilk boşluk dışı karakteri # olan satırlar yoksayılır.
• Mantıksal bir satır, boşlukla başlamayan bir metinle başlar. Boşlukla başlayan bir satır, mantıksal bir satırı devam ettirir.
Anahtar ve değer, etrafındaki boşlukların temizlenmesi dışında olduğu gibi işlenir. Arama anahtarlarında boşluk kullanımı Postfix 3.2 sürümünden itibaren desteklenmektedir.
Anahtar, e-posta adresi bilgisi belirttiğinde, RFC 5322 gerektiriyorsa yerel kısım (localpart) çift tırnak içine alınmalıdır. Örneğin, ";" içeren bir adres yerel kısmı veya "." ile başlayan ya da biten bir yerel kısım.
Varsayılan olarak, aramaların büyük/küçük harfe duyarsız olması için arama anahtarı küçük harfe dönüştürülür; Postfix 2.3 sürümünden itibaren bu harf dönüştürme işlemi yalnızca btree:, dbm: veya hash: gibi arama anahtarları sabit harfli dizeler olan tablolarla gerçekleştirilir. Önceki sürümlerde arama anahtarı, regexp: ve pcre: gibi bir arama alanının hem büyük hem de küçük harfli metinlerle eşleşebildiği tablolar için bile dönüştürülüyordu. Bu durum, $number ikamelerinde bilgi kaybına yol açıyordu.
Komut Satırı Argümanları
-b: İleti gövdesi sorgulama modunu etkinleştirir. "-q -" seçeneğiyle standart girdiden arama anahtarları okunurken, girdiyi RFC 5322 biçimindeki bir e-posta iletisiymiş gibi işler. Gövde içeriğinin her bir satırı bir arama anahtarı haline gelir.
Varsayılan olarak, -b seçeneği arama anahtarlarını üretmeye ilk üst bilgi dışı satırdan başlar ve iletinin sonuna ulaşıldığında durur. body_checks(5) işlemini simüle etmek için -m seçeneği ile MIME ayrıştırmasını etkinleştirin. Bununla birlikte, -b seçeneği ek MIME üst bilgileri ve ekli message/* üst bilgileri için gövde tarzı arama anahtarları üretmez.
NOT: "smtputf8_enable = yes" olduğunda, -b seçeneği sorgu anahtarları ve arama sonuçlarındaki UTF-8 sözdizimi denetimlerini devre dışı bırakır. Her şeye rağmen UTF-8 sözdizimi denetimlerini zorlamak için -U seçeneğini belirtin.
Bu özellik Postfix 2.6 ve sonraki sürümlerinde mevcuttur.
-c config_dir Varsayılan yapılandırma dizini yerine belirtilen dizindeki main.cf yapılandırma dosyasını okur.
-d key Search the specified maps for key and remove one entry per map.: İstenen bilgi bulunduğunda çıkış durumu sıfırdır.
Eğer anahtar değeri olarak - belirtilirse, program standart girdi akışından anahtar değerlerini okur. İstenen anahtarlardan en az biri bulunduğunda çıkış durumu sıfırdır.
-f: Bir tablo oluşturulurken veya sorgulanırken arama anahtarını küçük harfe dönüştürmez.
Postfix 2.3 ve sonraki sürümlerinde bu seçeneğin düzenli ifade (regular expression) tabloları için bir etkisi yoktur. Bu tablolarda harf dönüştürme, bir kalıba bayrak eklenerek kontrol edilir.
-h: İleti üst bilgisi sorgulama modunu etkinleştirir. "-q -" seçeneğiyle standart girdiden arama anahtarları okunurken, girdiyi RFC 5322 biçimindeki bir e-posta iletisiymiş gibi işler. Her mantıksal üst bilgi satırı bir arama anahtarı haline gelir. Çok satırlı bir üst bilgi, bir veya daha fazla gömülü yeni satır karakteri içeren tek bir arama anahtarı haline gelir.
Varsayılan olarak, -h seçeneği ilk üst bilgi dışı satıra ulaşılana kadar arama anahtarlarını üretir. header_checks(5) işlemini simüle etmek için -m seçeneği ile MIME ayrıştırmasını etkinleştirin. Bununla birlikte, -h seçeneği ek MIME üst bilgileri ve ekli message/* üst bilgileri için de üst bilgi tarzı arama anahtarları üretir.
NOT: "smtputf8_enable = yes" olduğunda, -b seçeneği sorgu anahtarları ve arama sonuçlarındaki UTF-8 sözdizimi denetimlerini devre dışı bırakır. Her şeye rağmen UTF-8 sözdizimi denetimlerini zorlamak için -U seçeneğini belirtin.
Bu özellik Postfix 2.6 ve sonraki sürümlerinde mevcuttur.
-i: Kademeli mod. Girdileri standart girdiden okur ve mevcut bir veritabanını temizlemez. Varsayılan olarak postmap(1), file_name içindeki girdilerden yeni bir veritabanı oluşturur.-m: "-b" ve "-h" seçenekleri ile MIME ayrıştırmasını etkinleştirir.
Bu özellik Postfix 2.6 ve sonraki sürümlerinde mevcuttur.
-N: Arama anahtarlarını ve değerlerini sonlandıran sonlandırıcı boş (null) karakteri dahil eder. Varsayılan olarak postmap(1), ana bilgisayar işletim sistemi için varsayılan olanı yapar.-n: Arama anahtarlarını ve değerlerini sonlandıran sonlandırıcı boş (null) karakteri dahil etmez. Varsayılan olarak postmap(1), ana bilgisayar işletim sistemi için varsayılan olanı yapar.-o: Kök (root) ayrıcalığına sahip olmayan bir girdi dosyası işlenirken kök ayrıcalıklarını bırakmaz. Varsayılan olarak postmap(1), kök ayrıcalıklarını bırakır ve kaynak dosyanın sahibi olarak çalışır.-p: Yeni bir dosya oluştururken girdi dosyasının dosya erişim izinlerini miras almaz. Bunun yerine, varsayılan erişim izinlerine (mod 0644) sahip yeni bir dosya oluşturur.
-q key Search the specified maps for key and write the first value found to the standard output stream. İstenen bilgi bulunduğunda çıkış durumu sıfırdır.
Eğer anahtar değeri olarak - belirtilirse, program standart girdi akışından anahtar değerlerini okur ve bulunan her anahtar için bir satır anahtar değeri çıktısı yazar. İstenen anahtarlardan en az biri bulunduğunda çıkış durumu sıfırdır.
-r: Bir tablo güncellenirken, mevcut girdileri güncelleme girişimleri hakkında uyarı vermez ve bu güncellemeleri yine de yapar.-s: Tüm veritabanı öğelerini alır ve her bir öğe için bir satır anahtar değeri çıktısı yazar. Ögeler veritabanı sırasında yazdırılır; bu sıra orijinal girdi sırasıyla aynı olmak zorunda değildir.
Bu özellik Postfix 2.2 ve sonraki sürümlerinde mevcuttur ve tüm veritabanı türleri için geçerli değildir.
-u: UTF-8 desteğini devre dışı bırakır. "smtputf8_enable = yes" olduğunda UTF-8 desteği varsayılan olarak etkindir. Anahtarların ve değerlerin geçerli UTF-8 dizeleri olmasını gerektirir.-U: "smtputf8_enable = yes" olduğunda, -b ve -h seçenekleriyle UTF-8 sözdizimi denetimlerini zorunlu kılar.-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ı giderek daha ayrıntılı hale getirir.-w: Bir tablo güncellenirken, mevcut girdileri güncelleme girişimleri hakkında uyarı vermez ve bu girişimleri yoksayar.
Argümanlar:
file_type Veritabanı türü. Hangi türlerin desteklendiğini öğrenmek için "postconf -m" komutunu kullanın.
postmap(1) komutu desteklenen herhangi bir dosya türünü sorgulayabilir ancak yalnızca aşağıdaki dosya türlerini oluşturabilir:
btree Çıktı dosyası, file_name.db adında bir btree dosyasıdır. Bu, db veritabanları desteği olan sistemlerde mevcuttur.
cdb Çıktı, file_name.cdb adında tek bir dosyadan oluşur. Bu, cdb veritabanları desteği olan sistemlerde mevcuttur.
dbm Çıktı, file_name.pag ve file_name.dir adında iki dosyadan oluşur. Bu, dbm veritabanları desteği olan sistemlerde mevcuttur.
hash Çıktı dosyası, file_name.db adında bir karma (hashed) dosyadır. Bu, db veritabanları desteği olan sistemlerde mevcuttur.
fail Tüm isteklerde güvenilir bir şekilde başarısız olan bir tablo. Arama tablosu adı yalnızca günlük kaydı için kullanılır. Bu tablo, Postfix hata testlerini basitleştirmek için mevcuttur.
sdbm Çıktı, file_name.pag ve file_name.dir adında iki dosyadan oluşur. Bu, sdbm veritabanları desteği olan sistemlerde mevcuttur.
Herhangi bir file_type belirtilmediğinde, yazılım default_database_type yapılandırma parametresi aracılığıyla belirtilen veritabanı türünü kullanır.
file_name Bir veritabanı yeniden oluşturulurken arama tablosu kaynak dosyasının adı.
Tanılama
Sorunlar standart hata akışına ve syslogd(8) servisine kaydedilir. Çıktı olmaması, hiçbir sorunun tespit edilmediği anlamına gelir. Çift girdiler atlanır ve bir uyarı ile işaretlenir.
postmap(1) başarı durumunda (başarılı "postmap -q" araması dahil) sıfır çıkış durumuyla, başarısızlık durumunda ise sıfır olmayan bir çıkış durumuyla sonlanır.
Ortam Değişkenleri
MAIL_CONFIG Postfix yapılandırma dosyalarının bulunduğu dizin.
MAIL_VERBOSE Hata ayıklama amacıyla ayrıntılı günlük kaydını etkinleştirir.
Yapılandırma Parametreleri
Aşağıdaki main.cf parametreleri özellikle bu programla ilgilidir. Aşağıdaki metin yalnızca parametrelerin bir özetini sunar. Örnekler dahil daha fazla ayrıntı için postconf(5) kılavuzuna bakın.
berkeley_db_create_buffer_size (16777216) Berkeley DB karma veya btree tabloları oluşturan programlar için tablo başına I/O arabellek boyutu.
berkeley_db_read_buffer_size (131072) Berkeley DB karma veya btree tablolarını okuyan programlar için tablo başına I/O arabellek boyutu.
config_directory ('postconf -d' çıktısına bakın) Postfix main.cf ve master.cf yapılandırma dosyalarının varsayılan konumu.
default_database_type ('postconf -d' çıktısına bakın) newaliases(1), postalias(1) ve postmap(1) komutlarında kullanılacak varsayılan veritabanı türü.
import_environment ('postconf -d' çıktısına bakın) Ayrıcalıklı bir Postfix sürecinin Postfix olmayan bir üst süreçten içe aktaracağı ortam parametrelerinin listesi veya ad=değer ortam geçersiz kılmaları.
smtputf8_enable (yes) RFC 6531..6533 belgelerinde açıklanan protokoller için ön SMTPUTF8 desteğini etkinleştirir.
syslog_facility (mail) Postfix günlük kaydının syslog olanağı (syslog facility).
syslog_name ('postconf -d' çıktısına bakın) Syslog kayıtlarında süreç adının başına eklenen bir önek; böylece örneğin "smtpd", "prefix/smtpd" haline gelir.
Ayrıca Bakınız
postalias(1), takma ad veritabanı oluşturma/güncelleme/sorgulama postconf(1), desteklenen veritabanı türleri postconf(5), yapılandırma parametreleri syslogd(8), sistem günlüğü
Benioku Dosyaları
Bu bilgiyi bulmak için "postconf readme_directory" veya "postconf html_directory" komutunu kullanın. DATABASE_README, Postfix arama tablosuna genel bakış
Lisans
Secure Mailer lisansı bu yazılımla birlikte dağıtılmalıdır.
Yazar(lar)
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
POSTMAP(1)