Sözdizimi
newsyslog [-CFNnrsv] [-R tagname] [-a directory] [-d directory] [-f config_file] [file ...]
Açıklama
newsyslog yardımcı programı, cron(8) tarafından periyodik olarak çalışacak şekilde planlanmalıdır. Çalıştırıldığında, gerekirse günlük dosyalarını arşivler. Bir günlük dosyasının arşivlenmesi gerektiği belirlenirse, newsyslog dosyaları şu şekilde yeniden düzenler: "logfile" (günlük dosyası) boş kalır, "logfile.0" içinde son dönemin günlükleri, "logfile.1" içinde sondan bir önceki dönemin günlükleri yer alır ve bu böyle, kullanıcının belirttiği arşivlenmiş günlük sayısına kadar devam eder. İsteğe bağlı olarak, alandan tasarruf etmek için arşivlenmiş günlükler sıkıştırılabilir.
Bir günlük üç nedenden dolayı arşivlenebilir:
Yapılandırılmış boyuttan (kilobayt cinsinden) daha büyüktür.
Günlüğün son arşivlenmesinden bu yana yapılandırılmış sayıda saat geçmiştir.
Bu, günlüğün döndürülmesi (rotation) için özel olarak yapılandırılmış saattir.
newsyslog'un hassasiyeti, cron(8) tarafından ne kadar sıklıkla çalıştırılacağına bağlıdır. Program oldukça hızlı çalıştığı için, herhangi bir olumsuz etki olmaksızın her saat başı çalışacak şekilde planlanabilir ve yukarıdaki üçüncü mod bunun böyle olduğunu varsayar.
Seçenekler
Aşağıdaki seçenekler newsyslog ile birlikte kullanılabilir:
-f config_file newsyslog'a yapılandırma dosyası olarak /etc/newsyslog.conf ve /etc/newsyslog.d/*.conf yerine config_file kullanmasını söyler.
-a directory Arşivlenmiş günlük dosyalarının yazılacağı bir dizin belirtir. Göreli (relative) bir yol verilirse, bu yol her bir günlük dosyasının yoluna eklenir ve elde edilen yol, o günlük dosyasının arşivlenmiş günlüğünün yazılacağı dizin olarak kullanılır. Mutlak (absolute) bir yol verilirse, tüm arşivlenmiş günlükler belirtilen dizine yazılır. Yol dizininin herhangi bir bileşeni mevcut değilse, newsyslog çalıştırıldığında oluşturulacaktır.
-d directory Tüm günlük dosyalarının göreli olacağı bir dizin belirtir. Kök dizin dışındaki günlüklerin arşivlenmesine izin vermek için, -a seçeneğine geçirilen dizin bundan etkilenmez.
-v: newsyslog'u ayrıntılı (verbose) moda geçirir. Bu modda, her bir günlüğü ve o günlüğün kırpılması veya atlanması nedenlerini yazdırır.-n: newsyslog'un günlükleri kırpmamasını, ancak bu seçenek belirtilmemiş olsaydı ne yapacağını yazdırmasını sağlar.-r: newsyslog'un root olarak çalıştırılması zorunluluğunu kaldırır. Elbette, newsyslog syslogd(8) programına bir HUP sinyali gönderemeyecektir, bu nedenle bu seçenek yalnızca hata ayıklama sırasında kullanılmalıdır.-s: newsyslog'un bir günlük dosyasını döndürürken normalde sinyal göndereceği herhangi bir arka plan programı (daemon) sürecine hiçbir sinyal göndermemesi gerektiğini belirtir. Döndürülen herhangi bir günlük dosyası için bu seçenek, bu seçenek olmasaydı sinyal alacak bir arka plan programı varsa döndürülen günlük dosyasının genellikle sıkıştırılmayacağı anlamına da gelir. Bununla birlikte, bu seçeneğin en çok -R seçeneği ile birlikte belirtildiğinde yararlı olması muhtemeldir ve bu durumda sıkıştırma işlemi yapılacaktır.-C: Bir kez belirtilirse, newsyslog mevcut olmayan ve yapılandırma dosyası girdilerinde C bayrağı belirtilen günlük dosyalarını oluşturur. Birden fazla kez belirtilirse, newsyslog henüz mevcut olmayan tüm günlük dosyalarını oluşturacaktır. Komut satırında günlük dosyaları belirtilmişse, -C veya -CC yalnızca o belirli günlük dosyalarına uygulanacaktır.-F: Kırpma koşulları karşılanmamış olsa bile newsyslog'u günlükleri kırpmaya zorlar. Bu seçenek, yalnızca sorunları içeren taze günlükler sağlayarak sistem sorunlarının teşhis edilmesinde yararlıdır.-N: Herhangi bir döndürme işlemi gerçekleştirmez. Bu seçeneğin, tek amacın günlük dosyalarını oluşturmak olduğu durumlarda -C veya -CC seçenekleriyle birlikte kullanılması amaçlanmıştır.
-R tagname
Kırpma koşulları bu dosyalar için karşılanmamış olsa bile newsyslog'un verilen dosya listesini döndürmesi gerektiğini belirtir. tagname yalnızca döndürülen günlük dosyalarına yazılan mesajlarda kullanılır. Bu seçeneğin -F seçeneğinden farkı, newsyslog'un yalnızca bu belirli dosyalar üzerinde işlem yapması için bir veya daha fazla günlük dosyasının da belirtilmesinin zorunlu olmasıdır. Bu seçenek esas olarak bazı günlük dosyaları yazan ve kendi kriterlerine göre döndürme işlemini tetiklemek isteyen arka plan programları veya programlar için tasarlanmıştır. Bu seçenekle, döndürmenin gerçekleşmesini istedikleri zaman newsyslog'u çalıştırarak bunu tetikleyebilir ve yine de sistem yöneticisine döndürme kurallarını (kaç tane yedek kopya tutulacağı ve ne tür bir sıkıştırma yapılacağı gibi) belirtme yolu sunabilirler. Bir arka plan programı newsyslog'u -R seçeneğiyle çalıştırdığında, newsyslog'u çağırmadan önce tüm günlük dosyalarının kapatıldığından emin olmalı ve ardından newsyslog geri döndüğünde dosyaları yeniden açmalıdır. Genellikle çağıran süreç, newsyslog'un döndürmeyi zorlamak için kendisini çağıran sürece sinyal göndermemesi için -s seçeneğini de belirtmek isteyecektir. Sinyal adımının atlanması, newsyslog normalde gönderilen herhangi bir sinyalden sonra birkaç saniye beklediğinden dolayı newsyslog'un daha hızlı geri dönmesi anlamına da gelecektir.
Ek komut satırı argümanları verilirse, newsyslog yalnızca bu argümanlarla eşleşen günlük dosyalarını inceleyecektir; aksi takdirde, yapılandırma dosyasında (dosyalarında) listelenen tüm dosyaları inceleyecektir.
Dosyalar
/etc/newsyslog.conf newsyslog yapılandırma dosyası /etc/newsyslog.d/ newsyslog yapılandırma dizini
Uyumluluk
newsyslog yardımcı programının önceki sürümleri, grup adını ayırt etmek için nokta (".") karakterini kullanıyordu. FreeBSD 3.3'ten başlayarak, kullanıcı ve grup adlarının nokta karakterini içerebilmesi için bu, iki nokta üst üste (":") karakteriyle değiştirilmiştir. Geriye dönük uyumluluk için nokta (".") karakteri hala kabul edilmektedir.
Tarihçe
newsyslog yardımcı programı NetBSD kaynaklıdır ve ilk olarak FreeBSD 2.2'de ortaya çıkmıştır.
Yazarlar
Theodore Ts'o, MIT Project Athena
Telif Hakkı 1987, Massachusetts Institute of Technology
Ayrıca Bakınız
bzip2(1), gzip(1), syslog(3), newsyslog.conf(5), chown(8), syslogd(8)
Hatalar
Güvenlik açıklarını bulmak için henüz günlükleri otomatik olarak okumamaktadır.
macOS 26.4 24 Şubat 2005 macOS 26.4