Özet
main.cf yönetimi:
postconf [-dfhHnopvx] [-c config_dir] [-C class,...] [parameter ...]
postconf [-epv] [-c config_dir] parameter=value ...
postconf -# [-pv] [-c config_dir] parameter ...
postconf -X [-pv] [-c config_dir] parameter ...
master.cf servis girdilerini yönetme:
postconf -M [-fovx] [-c config_dir] [service[/type] ...]
postconf -M [-ev] [-c config_dir] service/type=value ...
postconf -M# [-v] [-c config_dir] service/type ...
postconf -MX [-v] [-c config_dir] service/type ...
master.cf servis alanlarını yönetme:
postconf -F [-fhHovx] [-c config_dir] [service[/type[/field]] ...]
postconf -F [-ev] [-c config_dir] service/type/field=value ...
master.cf servis parametrelerini yönetme:
postconf -P [-fhHovx] [-c config_dir] [service[/type[/parameter]] ...]
postconf -P [-ev] [-c config_dir] service/type/parameter=value ...
postconf -PX [-v] [-c config_dir] service/type/parameter ...
Geri dönen (bounce) ileti şablonlarını yönetme:
postconf -b [-v] [-c config_dir] [template_file]
postconf -t [-v] [-c config_dir] [template_file]
TLS özelliklerini yönetme:
postconf -T mode [-v] [-c config_dir]
Diğer yapılandırmaları yönetme:
postconf -a|-A|-l|-m [-v] [-c config_dir]Açıklama
Varsayılan olarak postconf(1) komutu, main.cf yapılandırma parametrelerinin değerlerini görüntüler ve olası hatalı yazılmış parametre adları hakkında uyarır (Postfix 2.9 ve sonrası). Komut ayrıca main.cf yapılandırma parametre değerlerini değiştirebilir veya Postfix e-posta sistemi hakkında diğer yapılandırma bilgilerini görüntüleyebilir.
Seçenekler:
-a: Postfix SMTP sunucusu için kullanılabilir SASL eklenti tiplerini listeler. Eklenti tipi, aşağıda listelenen adlardan biri belirtilerek smtpd_sasl_type yapılandırma parametresi ile seçilir.
cyrus Bu sunucu eklentisi, Postfix, Cyrus SASL desteğiyle derlendiğinde kullanılabilir.
dovecot Bu sunucu eklentisi, Dovecot kimlik doğrulama sunucusunu kullanır ve Postfix herhangi bir SASL desteğiyle derlendiğinde kullanılabilir.
Bu özellik Postfix 2.3 ve sonrasında mevcuttur.
-A: Postfix SMTP istemcisi için kullanılabilir SASL eklenti tiplerini listeler. Eklenti tipi, aşağıda listelenen adlardan biri belirtilerek smtp_sasl_type veya lmtp_sasl_type yapılandırma parametreleri ile seçilir.
cyrus Bu istemci eklentisi, Postfix, Cyrus SASL desteğiyle derlendiğinde kullanılabilir.
Bu özellik Postfix 2.3 ve sonrasında mevcuttur.
-b [template_file] bounce(5) içinde açıklandığı gibi $name ifadelerini gerçek değerlerle genişleterek, teslimat durumu bildirimi (DSN) iletilerinin başında görünen ileti metnini görüntüler.
bounce_template_file parametre ayarını geçersiz kılmak için, "postconf -b" komut satırının sonuna bir şablon dosya adı belirtin. Yerleşik şablonları görüntülemek için boş bir dosya adı belirtin (kabuk dilinde: "").
Bu özellik Postfix 2.3 ve sonrasında mevcuttur.
-c config_dir main.cf yapılandırma dosyası, varsayılan yapılandırma dizini yerine belirtilen dizindedir.
-C class,... main.cf parametrelerini görüntülerken, yalnızca belirtilen sınıftan/sınıflardan olan parametreleri seçer:
builtin Yerleşik adlara sahip parametreler.
service Servis tarafından tanımlanmış adlara sahip parametreler (bir master.cf girdisinin ilk alanı artı Postfix tarafından tanımlanmış bir sonek).
user Kullanıcı tarafından tanımlanmış adlara sahip parametreler.
all Yukarıdaki tüm sınıflar.
Varsayılan durum, "-C all" belirtilmiş gibidir.
Bu özellik Postfix 2.9 ve sonrasında mevcuttur.
-d: Gerçek ayarlar yerine varsayılan main.cf parametre ayarlarını yazdırır. İnsanlar tarafından kolayca okunabilmesi amacıyla uzun satırları katlamak için -df belirtin (Postfix 2.9 ve sonrası).-e: main.cf yapılandırma dosyasını düzenler ve parametre ayarlarını postconf(1) komut satırındaki "ad=değer" çiftleriyle günceller.
-M ile birlikte kullanıldığında, master.cf yapılandırma dosyasını düzenler ve bir veya daha fazla servis girdisini postconf(1) komut satırında "servis/tip=değer" ile belirtilen yeni değerlerle değiştirir.
-F ile birlikte kullanıldığında, master.cf yapılandırma dosyasını düzenler ve bir veya daha fazla servis alanını postconf(1) komut satırında "servis/tip/alan=değer" ile belirtilen yeni değerlerle değiştirir. Şu anda "command" (komut) alanı, komut adını ve komut argümanlarını içermektedir. Bu durum yakın gelecekte değişebilir; böylece "command" alanı yalnızca komut adını içerecek ve yeni bir "arguments" (argümanlar) sözde alanı (pseudofield) komut argümanlarını içerecektir.
-P ile birlikte kullanıldığında, master.cf yapılandırma dosyasını düzenler ve bir veya daha fazla servis parametresi ayarını (-o parametre=değer ayarları), postconf(1) komut satırında "servis/tip/parametre=değer" ile belirtilen yeni değerlerle ekler veya günceller.
Tüm durumlarda dosya geçici bir dosyaya kopyalanır, ardından asıl yerine yeniden adlandırılır. postconf(1) komut satırındaki özel karakterleri ve boşlukları korumak için tırnak işaretleri kullanın.
Postfix sürüm 2.8 ve sonrasında artık -e seçeneğine ihtiyaç duyulmamaktadır.
-f: İnsanlar tarafından kolayca okunabilmesi için, main.cf veya master.cf yapılandırma dosyası girdilerini yazdırırken uzun satırları katlar.
Bu özellik Postfix 2.9 ve sonrasında mevcuttur.
-F: master.cf girdi başına alan ayarlarını (varsayılan olarak tüm servisler ve tüm alanlar), her satırda bir tane olacak şekilde "servis/tip/alan=değer" biçiminde gösterir. Uzun satırları katlamak için -Ff belirtin.
Çıktıyı ilgilendiğiniz alanlarla sınırlamak için postconf(1) komut satırında bir veya daha fazla "servis/tip/alan" örneği belirtin. Belirtilmeyen sondaki parametre adı veya servis tipi alanları, "*" joker (wildcard) alanları olarak ele alınacaktır.
Bu özellik Postfix 2.11 ve sonrasında mevcuttur.
-h: Normalde değerden önce gelen "ad = " etiketi olmadan parametre veya nitelik değerlerini gösterir.-H: Normalde adı takip eden " = değer" kısmı olmadan parametre veya nitelik adlarını gösterir.
Bu özellik Postfix 3.1 ve sonrasında mevcuttur.
-l: Desteklenen tüm posta kutusu kilitleme yöntemlerinin adlarını listeler. Postfix aşağıdaki yöntemleri destekler:
flock Yalnızca yerel dosyalar için çekirdek tabanlı bir tavsiyeli (advisory) kilitleme yöntemi. Bu kilitleme yöntemi, BSD uyumlu bir kütüphaneye sahip sistemlerde mevcuttur.
fcntl Yerel ve uzak dosyalar için çekirdek tabanlı bir tavsiyeli kilitleme yöntemi.
dotlock Uygulama düzeyinde bir kilitleme yöntemi. Bir uygulama, dosyaadı adındaki bir dosyayı, dosyaadı.lock adında bir dosya oluşturarak kilitler. Uygulamanın, anormal program sonlandırmalarından sonra geride kalan eski lock dosyalarının yanı sıra kendi lock dosyasını da kaldırması beklenir.
-m: Desteklenen tüm arama tablosu (lookup table) tiplerinin adlarını listeler. Postfix yapılandırma dosyalarında, arama tabloları tip:ad şeklinde belirtilir; burada tip, aşağıda listelenen tiplerden biridir. Tablo adı söz dizimi, DATABASE_README belgesinde açıklandığı gibi arama tablosu tipine bağlıdır.
btree Sıralı, dengeli bir ağaç yapısı. Berkeley DB veritabanı desteğine sahip sistemlerde mevcuttur.
cdb Artımlı (incremental) güncellemeleri desteklemeyen, okuma odaklı optimize edilmiş bir yapı. CDB veritabanı desteğine sahip sistemlerde mevcuttur.
Bu özellik Postfix 2.2 ve sonrasında mevcuttur.
cidr Değerleri Sınıfsız Alanlar Arası Yönlendirme (Classless Inter-Domain Routing - CIDR) kalıplarıyla ilişkilendiren bir tablo. Bu durum cidr_table(5) içinde açıklanmıştır.
Bu özellik Postfix 2.2 ve sonrasında mevcuttur.
dbm Karma tabanlı (hashing) dizinlenmiş bir dosya tipi. DBM veritabanı desteğine sahip sistemlerde mevcuttur.
environ UNIX işlem çevre değişkeni (environment) dizisi. Arama anahtarı, çevre değişkeni adıdır; tablo adı göz ardı edilir. Başlangıçta test amaçlı uygulanmış olup günün birinde birileri bunu yararlı bulabilir.
fail Tüm istekleri güvenilir bir şekilde başarısız kılan bir tablo. Arama tablosu adı günlükleme (logging) için kullanılır. Bu tablo, Postfix hata testlerini basitleştirmek amacıyla mevcuttur.
Bu özellik Postfix 2.9 ve sonrasında mevcuttur.
hash Karma tabanlı dizinlenmiş bir dosya tipi. Berkeley DB veritabanı desteğine sahip sistemlerde mevcuttur.
inline (salt okunur) Paylaşılmayan, bellek içi bir arama tablosu. Örnek: "inline:{ key=value, { key = text with whitespace or comma }}". Anahtar-değer çiftleri boşluk veya virgülle ayrılır; "{" işaretinden sonraki ve "}" işaretinden önceki boşluklar yoksayılır. Satır içi (inline) tablolar, sadece birkaç sabit öğe için bir veritabanı dosyası oluşturma ihtiyacını ortadan kaldırır. Ayrıca static: eşleme tipine bakın.
Bu özellik Postfix 3.0 ve sonrasında mevcuttur.
internal Paylaşılmayan, bellek içi bir karma tablosu. Bir işlem sonlandırıldığında içeriği kaybolur.
lmdb OpenLDAP LMDB veritabanı (belleğe eşlenmiş, kalıcı bir dosya). LMDB veritabanı desteğine sahip sistemlerde mevcuttur. Bu durum lmdb_table(5) içinde açıklanmıştır.
Bu özellik Postfix 2.11 ve sonrasında mevcuttur.
ldap (salt okunur) LDAP veritabanı istemcisi. Bu durum ldap_table(5) içinde açıklanmıştır.
memcache Memcache veritabanı istemcisi. Bu durum memcache_table(5) içinde açıklanmıştır.
Bu özellik Postfix 2.9 ve sonrasında mevcuttur.
mysql (salt okunur) MySQL veritabanı istemcisi. MySQL veritabanı desteğine sahip sistemlerde mevcuttur. Bu durum mysql_table(5) içinde açıklanmıştır.
pcre (salt okunur) Perl Uyumlu Düzenli İfadeler (Perl Compatible Regular Expressions - PCRE) tabanlı bir arama tablosu. Dosya biçimi pcre_table(5) içinde açıklanmıştır.
pgsql (salt okunur) PostgreSQL veritabanı istemcisi. Bu durum pgsql_table(5) içinde açıklanmıştır.
Bu özellik Postfix 2.1 ve sonrasında mevcuttur.
pipemap (salt okunur) Bir tablolar boru hattı (pipeline) oluşturan arama tablosu. Örnek: "pipemap:{type_1:name_1, ..., type_n:name_n}". Her bir "pipemap:" sorgusu ilk tabloya verilir. Her bir arama sonucu boru hattındaki bir sonraki tablo için sorgu haline gelir ve son tablo nihai sonucu üretir. Herhangi bir tablo araması sonuç vermediğinde, boru hattı da sonuç vermez. "pipemap:" tablo adının ilk ve son karakterleri "{" ve "}" olmalıdır. Bunların içinde, bireysel eşlemeler virgül veya boşlukla ayrılır.
Bu özellik Postfix 3.0 ve sonrasında mevcuttur.
proxy Postfix veritabanlarına paylaşımlı erişim için Postfix proxymap(8) istemcisi. Tablo adı söz dizimi tip:ad şeklindedir.
Bu özellik Postfix 2.0 ve sonrasında mevcuttur.
randmap (salt okunur) Rastgele seçim yapan bellek içi bir tablo. Örnek: "randmap:{result_1, ..., result_n}". Her tablo sorgusu, belirtilen sonuçlar arasından rastgele bir seçim döndürür. "randmap:" tablo adının ilk ve son karakterleri "{" ve "}" olmalıdır. Bunların içinde, bireysel sonuçlar virgül veya boşlukla ayrılır. Belirli bir sonuca daha fazla ağırlık vermek için onu birden fazla kez belirtin.
Bu özellik Postfix 3.0 ve sonrasında mevcuttur.
regexp (salt okunur) Düzenli ifadeler tabanlı bir arama tablosu. Dosya biçimi regexp_table(5) içinde açıklanmıştır.
sdbm Karma tabanlı dizinlenmiş bir dosya tipi. SDBM veritabanı desteğine sahip sistemlerde mevcuttur.
Bu özellik Postfix 2.2 ve sonrasında mevcuttur.
socketmap (salt okunur) Sendmail tarzı socketmap istemcisi. Tablo adı, bir TCP/IP sunucusu için inet:ana_makine:port:ad veya bir UNIX-alanı (UNIX-domain) sunucusu için unix:dosya_yolu:ad şeklindedir. Bu durum socketmap_table(5) içinde açıklanmıştır.
Bu özellik Postfix 2.10 ve sonrasında mevcuttur.
sqlite (salt okunur) SQLite veritabanı. Bu durum sqlite_table(5) içinde açıklanmıştır.
Bu özellik Postfix 2.8 ve sonrasında mevcuttur.
static (salt okunur) Arama sonucu olarak her zaman kendi adını döndüren bir tablo. Örneğin, static:foobar arama sonucu olarak her zaman foobar dizesini döndürür. Sonuç boşluk içerdiğinde "static:{ text with whitespace }" belirtin; bu form "{" işaretinden sonraki ve "}" işaretinden önceki boşlukları yoksayar. Ayrıca inline: eşlemesine bakın.
"static:{text}" biçimi Postfix 3.0 ve sonrasında mevcuttur.
tcp (salt okunur) TCP/IP istemcisi. Protokol tcp_table(5) içinde açıklanmıştır.
texthash (salt okunur) Dosyayı kullanabilmek için öncesinde postmap(1) komutunu çalıştırmanıza gerek olmaması ve dosya okunduktan sonraki değişiklikleri algılamaması dışında hash: dosyalarıyla benzer sonuçlar üretir.
Bu özellik Postfix 2.8 ve sonrasında mevcuttur.
unionmap (salt okunur) Her bir sorguyu birden fazla arama tablosuna gönderen ve bulunan tüm sonuçları virgülle ayrılmış şekilde birleştiren bir tablo. Tablo adı söz dizimi pipemap ile aynıdır.
Bu özellik Postfix 3.0 ve sonrasında mevcuttur.
unix (salt okunur) UNIX kimlik doğrulama veritabanının sınırlı bir görünümü. Aşağıdaki tablolar uygulanmıştır:
unix:passwd.byname Bu tablo UNIX parola veritabanıdır. Anahtar bir kullanıcı giriş (login) adıdır. Sonuç, passwd(5) biçiminde bir parola dosyası girdisidir.
unix:group.byname Bu tablo UNIX grup veritabanıdır. Anahtar bir grup adıdır. Sonuç, group(5) biçiminde bir grup dosyası girdisidir.
Postfix'in nasıl derlendiğine bağlı olarak diğer tablo tipleri de mevcut olabilir.
-M: main.cf dosya içeriği yerine master.cf dosya içeriğini gösterir. İnsanlar tarafından kolayca okunabilmesi amacıyla uzun satırları katlamak için -Mf belirtin.
Her biri master.cf girdisinin ilk alanı olan servis-adı (service-name) ve (inet, unix, fifo veya pass) değerlerinden biri olan servis-tipi (service-type) çifti içeren sıfır veya daha fazla argüman belirtin.
Eğer servis-adı veya servis-adı/servis-tipi belirtilirse, yalnızca eşleşen master.cf girdileri çıktı olarak verilecektir. Örneğin "postconf -Mf smtp", "smtp" adlı tüm servisleri çıktı olarak verirken "postconf -Mf smtp/inet" yalnızca ağ üzerinden dinleme yapan smtp servisini çıktı olarak verecektir. Belirtilmeyen sondaki servis tipi alanları, "*" joker (wildcard) alanları olarak ele alınacaktır.
Bu özellik Postfix 2.9 ve sonrasında mevcuttur. Söz dizimi "ad.tip" yerine "ad/tip" olarak değiştirilmiş ve Postfix 2.11 ile "*" joker desteği eklenmiştir.
-n: Yalnızca main.cf içinde açıkça ad=değer ayarları yapılmış olan yapılandırma parametrelerini gösterir. İnsanlar tarafından kolayca okunabilmesi amacıyla uzun satırları katlamak için -nf belirtin (Postfix 2.9 ve sonrası).
-o name=value main.cf parametre ayarlarını geçersiz kılar.
Bu özellik Postfix 2.10 ve sonrasında mevcuttur.
-p: main.cf parametre ayarlarını gösterir. Varsayılan davranış budur.
Bu özellik Postfix 2.11 ve sonrasında mevcuttur.
-P: master.cf servis parametre ayarlarını (varsayılan olarak tüm servisler ve tüm parametreler), her satırda bir tane olacak şekilde "servis/tip/parametre=değer" biçiminde gösterir. Uzun satırları katlamak için -Pf belirtin.
Çıktıyı ilgilendiğiniz parametrelerle sınırlamak için postconf(1) komut satırında bir veya daha fazla "servis/tip/parametre" örneği belirtin. Belirtilmeyen sondaki parametre adı veya servis tipi alanları, "*" joker (wildcard) alanları olarak ele alınacaktır.
Bu özellik Postfix 2.11 ve sonrasında mevcuttur.
-t [template_file] $name ifadelerini genişletmeden, teslimat durumu bildirimi (DSN) iletilerinin başında görünen metinlerin şablonlarını görüntüler.
bounce_template_file parametre ayarını geçersiz kılmak için, "postconf -t" komut satırının sonuna bir şablon dosya adı belirtin. Yerleşik şablonları görüntülemek için boş bir dosya adı belirtin (kabuk dilinde: "").
Bu özellik Postfix 2.3 ve sonrasında mevcuttur.
-T mode Eğer Postfix, TLS desteği olmadan derlenmişse, -T seçeneği hiçbir çıktı üretmez. Aksi takdirde, geçersiz bir mod belirtilirse, -T seçeneği bir hata bildirir ve sıfır olmayan bir durum koduyla sonlanır. Geçerli modlar şunlardır:
compile-version Postfix'in derlendiği OpenSSL sürümünü (yani bir başlık dosyasındaki OpenSSL sürümünü) çıktı olarak verir. Çıktı biçimi "openssl version" komutu ile aynıdır.
run-version Postfix'in çalışma zamanında bağlandığı (linked) OpenSSL sürümünü (yani paylaşılan bir kütüphanedeki OpenSSL sürümünü) çıktı olarak verir.
public-key-algorithms Desteklenen açık anahtar algoritmalarının küçük harfli adlarını her satırda bir tane olacak şekilde çıktı olarak verir.
Bu özellik Postfix 3.1 ve sonrasında mevcuttur.
-v: Hata ayıklama amacıyla ayrıntılı günlüklemeyi (verbose logging) etkinleştirir. Birden fazla -v seçeneği, yazılımın giderek daha ayrıntılı bilgi vermesini sağlar.-x: main.cf veya master.cf parametre değerlerindeki $name ifadesini genişletir. Genişletme yinelemelidir (recursive).
Bu özellik Postfix 2.10 ve sonrasında mevcuttur.
-X: main.cf yapılandırma dosyasını düzenler ve postconf(1) komut satırında adı geçen parametreleri kaldırır. "ad=değer" çiftleri değil, bir parametre adları listesi belirtin.
-M ile birlikte kullanıldığında, master.cf yapılandırma dosyasını düzenler ve postconf(1) komut satırında "servis/tip" ile belirtilen bir veya daha fazla servis girdisini kaldırır.
-P ile birlikte kullanıldığında, master.cf yapılandırma dosyasını düzenler ve postconf(1) komut satırında "servis/tip/parametre" ile belirtilen bir veya daha fazla servis parametresi ayarını (-o parametre=değer ayarları) kaldırır.
Tüm durumlarda dosya geçici bir dosyaya kopyalanır, ardından asıl yerine yeniden adlandırılır. postconf(1) komut satırındaki özel karakterleri korumak için tırnak işaretleri kullanın.
Bu işlemin tersini gerçekleştirecek bir postconf(1) komutu yoktur.
Bu özellik Postfix 2.10 ve sonrasında mevcuttur. -M ve -P desteği Postfix 2.11 ile eklenmiştir.
-# main.cf yapılandırma dosyasını düzenler ve postconf(1) komut satırında adı geçen parametreleri yorum satırı haline getirir (comment out), böylece bu parametreler varsayılan değerlerine geri döner. "ad=değer" çiftleri değil, bir parametre adları listesi belirtin.
-M ile birlikte kullanıldığında, master.cf yapılandırma dosyasını düzenler ve postconf(1) komut satırında "servis/tip" ile belirtilen bir veya daha fazla servis girdisini yorum satırı haline getirir.
Tüm durumlarda dosya geçici bir dosyaya kopyalanır, ardından asıl yerine yeniden adlandırılır. postconf(1) komut satırındaki özel karakterleri korumak için tırnak işaretleri kullanın.
Bu işlemin tersini gerçekleştirecek bir postconf(1) komutu yoktur.
Bu özellik Postfix 2.6 ve sonrasında mevcuttur. -M desteği Postfix 2.11 ile eklenmiştir.
Teşhisler
Sorunlar standart hata akışına bildirilir.
Ortam
MAIL_CONFIG Postfix yapılandırma dosyalarını içeren dizin.
Yapılandırma Parametreleri
Aşağıdaki main.cf parametreleri özellikle bu programla ilgilidir.
Aşağıdaki metin yalnızca parametre özeti sunmaktadır. Örnekleri de içeren daha fazla ayrıntı için postconf(5) kılavuzuna bakın.
config_directory ('postconf -d' çıktısına bakın) Postfix main.cf ve master.cf yapılandırma dosyalarının varsayılan konumu.
bounce_template_file (boş) Geri dönen (bounce) ileti şablonlarını içeren bir yapılandırma dosyasının yol adı.
Dosyalar
/etc/postfix/main.cf, Postfix yapılandırma parametreleri /etc/postfix/master.cf, Postfix ana arka plan programı (master daemon) yapılandırması
Ayrıca Bakınız
bounce(5), geri dönen ileti şablonu dosya biçimi master(5), master.cf yapılandırma dosyası söz dizimi postconf(5), main.cf yapılandırma dosyası söz dizimi
Benioku (Readme) Dosyaları
Bu bilgileri bulmak için "postconf readme_directory" veya "postconf html_directory" komutlarını kullanın. DATABASE_README, Postfix arama tablosu 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
POSTCONF(1)