<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.tr.xsl"?>
<!-- English Revision: 1492708 -->
<!-- =====================================================
 Translated by: Nilgün Belma Bugüner <nilgun belgeler.gen.tr>
   Reviewed by: Orhan Berent <berent belgeler.gen.tr>
========================================================== -->

<!--
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
 this work for additional information regarding copyright ownership.
 The ASF licenses this file to You under the Apache License, Version 2.0
 (the "License"); you may not use this file except in compliance with
 the License.  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<manualpage metafile="rotatelogs.xml.meta">
<parentdocument href="./">Programlar</parentdocument>

  <title>rotatelogs - Apache günlüklerini döndürmek için borulu günlük kayıt
  programı</title>

<summary>
     <p><code><strong>rotatelogs</strong></code>, Apache'nin borulu günlük
     dosyaları özelliği ile birlikte kullanmak için tasarlanmış basit bir
     programdır. Günlük dosyasının azami boyutuna göre veya belli aralıklarla
     günlük dosyalarını döndürür.</p>
</summary>

<section id="synopsis"><title>Kullanım</title>

     <p><code><strong>rotatelogs</strong>
     [ -<strong>l</strong> ]
     [ -<strong>L</strong> <var>isim</var> ]
     [ -<strong>p</strong> <var>program</var> ]
     [ -<strong>f</strong> ]
     [ -<strong>v</strong> ]
     [ -<strong>e</strong> ]
     [ -<strong>c</strong> ]
     [ -<strong>n</strong> <var>dosya_sayısı</var> ]
     <var>dosyaismi</var>
     <var>süre</var>|<var>boyut</var>(B|K|M|G)
     [ <var>saat_farkı</var> ]</code></p>
</section>

<section id="options"><title>Seçenekler</title>

<dl>
    <dt><code><strong>-l</strong></code></dt>
    <dd>GMT yerine yerel zamanın kullanılmasını sağlar.</dd>

    <dt><code><strong>-L</strong></code> <var>bagismi</var></dt>
    <dd>Belirtilen bağ dosyası ismine geçerli günlük dosyasından kalıcı bir bağ
    oluşturulur. <code>tail -F bagismi</code> gibi bir komut kullanılarak
    günlüğün sürekli izlenmesi için kullanılabilir.</dd>

    <dt><code><strong>-p</strong></code> <var>program</var></dt>

    <dd>Belirtildiği takdirde, <code><strong>rotatelogs</strong></code> yeni
    bir günlük dosyasının her açılışında belirtilen programı çalıştırır. Yeni
    açılan dosyanın ismi programa ilk argüman olarak aktarılır. Bu işlem bir
    döndürme sonrası yapılırsa eski günlük dosyası ikinci argüman olarak
    aktarılır. <code><strong>rotatelogs</strong></code> işlemini sürdürmek için
    belirtilen programın sonlanmasını beklemez, dolayısıyla sonlanma soucunda
    döndürülen hata kodunu günlüğe kaydetmez. Çalıştırılan program
    <code><strong>rotatelogs</strong></code> ile aynı stdin, stdout ve stderr'i
    kullanır ve ortamı da miras alır.</dd>

    <dt><code><strong>-f</strong></code></dt>
    <dd>İlk günlük giridisinin okunmasını beklemeden
    <code><strong>rotatelogs</strong></code> başlar başlamaz günlük
    dosyasının açılmasını sağlar. Çok meşgul sitelerde, sunucu başlatılıp ilk
    istek sunuluncaya kadar geçen zamanda günlük dosyasının yokluğu
    özdevinimli işlemler yapan bazı günlükleme araçlarında sorunlara yol
    açabilir. Bu seçenek bu gibi durumlarda yararlıdır.</dd>

    <dt><code><strong>-t</strong></code></dt>
    <dd>Günlük dosyasının döndürülmek yerine tepeden kırpılmasına sebep olur.
    Günlüğün <code><strong>tail</strong></code> gibi bir araç tarafından gerçek
    zamanda işlendiği ve veriyi saklamanın gerekmediği durumda kullanışlıdır.
    Dosya ismine bir sonek eklenmez, ancak biçem dizgesi '%' karakteri
    içeriyorsa buna uyulur.</dd>

    <dt><code><strong>-v</strong></code></dt>
    <dd>Standart hataya verilen çıktı daha ayrıntılı olur. Çıktı,
    yapılandırma çözümlemesinin sonuçlarını ve tüm dosya açma/kapama
    işlemlerini içerir.</dd>

    <dt><code><strong>-e</strong></code></dt>
    <dd>Günlüğü standart çıktıya basar. Günlüğün zincirdeki ilgili araç
    tarafından gerçek zamanda işlenmesi gerektiğinde kullanışlıdır.</dd>

    <dt><code><strong>-c</strong></code></dt>
    <dd>Create log file for each interval, even if empty.</dd>

    <dt><code><strong>-n</strong> <var>dosya_sayısı</var></code></dt>
    <dd>Zaman damgalarına bakılmaksızın bir dosya serisi açılır. Örneğin -n3
      belirtilirse "logfile", "logfile.1", "logfile.2" serisi açılır ve
      "logfile" üzerine yazılır.</dd>

    <dt><code><var>dosyaismi</var></code></dt>
    <dd><p>Günlük dosyasının ismi yoluyla birlikte belirtilir.
      <var>dosyaismi</var> '%' karakterleri içeriyorsa bunlar
      <code>strftime(3)</code> biçem belirteçleri olarak ele alınır. Aksi
      takdirde, özdevinimli olarak <var>.nnnnnnnnnn</var> uzantısı üretilir.
      (<code><strong>-t</strong></code> seçeneği kullanılmadıkça) Uzantı saniye
      cinsindendir  ve her iki durumda da bu değer, mevcut döngü
      diliminin başlangıcına göre hesaplanır. Örneğin, döndürmenin 86400
      saniyede bir yapılacağı belirtilmişse, <code>strftime(3)</code> biçeminde
      oluşturulan saat, dakika ve saniye alanları, 24 saatlik sürenin
      başlangıcını (geceyarısı) göstermek üzere sıfırlarla doldurulur.</p>

      <p><code>strftime(3)</code> dosyaismi biçemlemesi kullanılırken, günlük
      dosyası biçeminin günlük dosyası döndürülürken her zaman farklı bir dosya
      ismi üretecek yeterlilikte parçacıklı yapıya sahip olduğundan emin
      olmalısınız. Aks takdirde döndürme işlemi yeni bir dosya başlatmak yerine
      hep aynı dosyanın üzerine yazar. Örneğin, <var>logfile</var> için
      <code>/var/logs/errorlog.%Y-%m-%d</code> belirtilmişse 5 mega baytta bir
      yeni bir günlük dosyasına başlanacaktır. Fakat 5 megabayta gün içinde iki
      kez ulaşılırsa aynı günlük dosyası üretilir ve günlük hep aynı dosyanın
      üzerine yazılır.</p>
    </dd>

    <dt><code><var>süre</var></code></dt>
    <dd>Günlük dosyasının yenisinin kaç saniyede bir açılacağı belirtilir.
    Örneğin, bu süre 3600 saniye ise günlük dosyası her saat başında
    yenilenir; 86400 saniye ise her geceyarısı yenilenir. (Bu süre zarfında
    günlüğe kaydedilecek bir olay gerçekleşmemişse dosya oluşturulmaz.)</dd>

    <dt><code><var>boyut</var>(B|K|M|G)</code></dt>
    <dd>Boyuta göre döndürme için azami dosya boyutu. Belirtilenin bir süre
    değil de bir boyut değeri olarak ele alınması için değerin sonuna şu
    karakterlerden biri eklenmelidir: <code>B</code> (Bayt), <code>K</code>
    (kilobayt), <code>M</code> (megabayt), <code>G</code> (gigabayt).

    <p>Süre ve boyut birlikte belirtilmişse boyut süreden sonra
    belirtilmelidir. Dosya yenilemesi, bunlardan hangisi daha önce aşılırsa o
    zaman gerçekleşir.</p></dd>

    <dt><code><var>saat_farkı</var></code></dt>
    <dd>Koordinatlı evrensel zamana göre "dakika" farkı. Belirtilmezse, sıfır
    öntanımlıdır. Örneğin, -5 saatlik bir zaman diliminde bulunuyorsanız bu
    değer <code>-300</code> olmalıdır. Çoğu durumda, bunun yerine
    <code><strong>-l</strong></code> seçeneğini kullanmak gerekir.</dd>
</dl>

</section>

<section id="examples"><title>Örnekler</title>

<example>
     CustomLog "|bin/rotatelogs /var/logs/logfile 86400" common
</example>

     <p>nnnn, günlük kaydının başladığı sistem zamanı olmak üzere
     /var/logs/logfile.nnnn dosyası oluşturulur. Bu zaman, daima döngü
     süresinin katları olacağından bunu cron betiklerinizi eşzamanlamakta
     kullanabilirsiniz. Her döngü süresinin sonunda (burada 24 saat sonra)
     yeni bir günlük dosyası açılır.</p>

<example>
     CustomLog "|bin/rotatelogs -l /var/logs/logfile.%Y.%m.%d 86400" common
</example>

     <p>yyyy, yıl; mm, ay; dd, ayın gününü belirtmek üzere
     /var/logs/logfile.yyyy.mm.dd dosyası oluşturulur. Her gün yerel zamanla
     geceyarısı yeni bir günlük dosyasına geçilecektir.</p>

<example>
     CustomLog "|bin/rotatelogs /var/logs/logfile 5M" common
</example>

     <p>Günlük dosyası 5 megabaytlık olunca yenisinin oluşturulmasını sağlar.
     </p>

<example>
     ErrorLog "|bin/rotatelogs /var/logs/errorlog.%Y-%m-%d-%H_%M_%S 5M"
</example>
     <p>Hata günlüğünün 5 megabaytta bir
     <code>errorlog.YYYY-mm-dd-HH_MM_SS</code> biçemli bir isimle
     oluşturulmasını sağlar.</p>

<example>
     CustomLog "|bin/rotatelogs -t /var/logs/logfile 86400" common
</example>

     <p>/var/logs/logfile dosyasını oluşturur, sunucu başlatılırken ve günde
       bir kere dosyanın tepesi kırpılır. Bu senaryoda ayrı bir sürecin (tail
       gibi) dosyayı gerçek zamanlı işleyeceği umulur.</p>

</section>

<section id="portability"><title>Taşınabilirlik</title>

    <p>Aşağıdaki günlük dosyası biçem belirteçlerinin tüm
    <code>strftime(3)</code> gerçeklenimlerince desteklenmesi gerekir.
    Kullandığınız kütüphaneye özgü belirteçler için sisteminizdeki
    <code>strftime(3)</code> kılavuz sayfasına bakınız.</p>

<table border="1" style="zebra">
<tr><td><code>%A</code></td><td>tam gün ismi (yerelleştirilmiş)</td></tr>
<tr><td><code>%a</code></td><td>3 harflik gün ismi
(yerelleştirilmiş)</td></tr>
<tr><td><code>%B</code></td><td>tam ay ismi (yerelleştirilmiş)</td></tr>
<tr><td><code>%b</code></td><td>3 harflik ay ismi (yerelleştirilmiş)</td></tr>
<tr><td><code>%c</code></td><td>tarih ve saat (yerelleştirilmiş)</td></tr>
<tr><td><code>%d</code></td><td>2 haneli ay günü numarası</td></tr>
<tr><td><code>%H</code></td><td>2 haneli saat (24 saatlik)</td></tr>
<tr><td><code>%I</code></td><td>2 haneli saat (12 saatlik)</td></tr>
<tr><td><code>%j</code></td><td>3 hanelik yıl günü numarası</td></tr>
<tr><td><code>%M</code></td><td>2 haneli dakika</td></tr>
<tr><td><code>%m</code></td><td>2 haneli ay</td></tr>
<tr><td><code>%p</code></td><td>12 saatlik kip için öö/ös
(yerelleştirilmiş)</td></tr>
<tr><td><code>%S</code></td><td>2 haneli saniye</td></tr>
<tr><td><code>%U</code></td><td>2 haneli yılın hafta numarası
(Haftanın ilk gününün Pazar olduğu varsayımıyla)</td></tr>
<tr><td><code>%W</code></td><td>2 haneli yılın hafta numarası
(Haftanın ilk gününün Pazartesi olduğu varsayımıyla)</td></tr>
<tr><td><code>%w</code></td><td>1 hanelik haftanın gün numarası
(Haftanın ilk gününün Pazar olduğu varsayımıyla)</td></tr>
<tr><td><code>%X</code></td><td>saat (yerelleştirilmiş)</td></tr>
<tr><td><code>%x</code></td><td>tarih (yerelleştirilmiş)</td></tr>
<tr><td><code>%Y</code></td><td>4 hanelik yıl</td></tr>
<tr><td><code>%y</code></td><td>2 hanelik yıl</td></tr>
<tr><td><code>%Z</code></td><td>zaman dilimi ismi</td></tr>
<tr><td><code>%%</code></td><td>`%' iminin kendisi</td></tr>
</table>

</section>
</manualpage>
