İSİM¶

KULLANIM¶

patch [seçenekler] [orjinal [yama]]

patch -psayı <yama

AÇIKLAMA¶

·

Başlık bir bağlamsal fark dosyası başlığı ise, patch eski ve yeni dosya isimlerini başlıktan alır. Eğer isimdeki bölü çizgilerinin sayısı -psayı veya --strip=sayı seçenekleri ile belirtilen kadar değilse bu isim yoksayılır. /dev/null ismi de ayrıca yoksayılır.

 

·

Yama olarak uygulanacak alanların dışında Index: ile başlayan satırlar varsa ve hem yeni hem de eski dosya isimleri belirtilmemişse veya patch POSIX uyumlu ise, patch dosya isimlerini Index: ile başlayan satırlardan alır.

 

·

Bundan sonraki kurallara uygun olmak üzere, aday dosya isimlerinin, başlıkta göründükleri sıraya bakılmaksızın, (eski, yeni, Index) düzeninde olacakları varsayılır.

 

·

Bazı isimli dosyalar mevcutsa, patch POSIX uyumluysa ilk dosya ismi değilse eniyi isim seçilir.

 

·

Eğer patch RCS, ClearCase ve SCCS'yi yoksaymıyorsa ( -g sayı veya --get=sayı seçeneklerine bakınız) ve isimli bir dosya mevcut değilse ama bir RCS, ClearCase veya SCCS ana dosyası varsa patch ilk isimli dosyayı RCS, ClearCase veya SCCS ana dosyası ile seçer.

 

·

İsimli dosya mevcut değilse, bir RCS, ClearCase veya SCCS ana dosyası da yoksa ama bazı dosya isimleri verilmişse, patch POSIX uyumlu değilse ve yamanın bir dosya oluşturması gerekiyorsa, patch en az dizin oluşturulacak şekilde en iyi dosya ismini seçer.

 

·

Şimdiye dek bahsedilen kurallarla hal bir dosya ismi seçilememişse, yamanacak dosyanın ismi size sorulur ve patch dosya ismini buna göre seçer.

 

| patch -d /usr/src/local/blurfl

SEÇENEKLER¶

-b, --backup

Dosyaların yedeğini oluşturur. Bir dosya yamanırken orjinal dosya silinmez, ya başka bir yere kopyalanır ya da ismi değiştirilir. Mevcut olmayan bir dosyanın yedeği yapılırken, olmayan dosyayı belirtmek için sadece ismi olan cismi olmayan (boş) bir dosya oluşturulur. Yedek dosya isimlerinin nasıl oluşturulduğu -V veya --version-control seçeneklerinin açıklamalarında bulunabilir.

 

--backup-if-mismatch

Yama bir dosya ile tam uyuşmazsa ve yedekleme istenmese de dosya yedeklenir. patch POSIX uyumlu değilse bu seçenek öntanımlı olarak uygulanır.

 

--no-backup-if-mismatch

Yama bir dosya ile tam uyuşmazsa ve yedekleme istense de dosya yedeklenmez. patch POSIX uyumlu değilse bu seçenek öntanımlı olarak uygulanır.

 

-B önek, --prefix=önek

Basit yedek dosya ismi oluşturulurken dosya isminin önüne önek getirilir. Örneğin, -B /junk/ ile dosya ismi src/patch/util.c olan bir dosyanın basit yedeği yapılırken dosya ismi /junk/src/patch/util.c yapılır.

 

--binary

Standart çıktı veya /dev/tty dışında tüm dosyalar için okuma ve yazma işlemleri iklik kipte yapılır. Bu seçenek POSIX uyumlu sistemlerde etkisizdir. DOS benzeri sistemlerde ise bu seçeneğin bir fark oluşturması için yama diff -a --binary ile üretilmiş olmalıdır.

 

-c, --context

Yama dosyası sıradan bir bağlamsal fark dosyası olarak yorumlanır.

 

-d dizin, --directory=dizin

Hiçbir şey yapmadan, hemen dizin dizinine geçilir.

 

-D tanım, --ifdef=tanım

Değişiklikleri işaretlemede #ifdef ... #endif yapısı tanım farklılaştırma sembolü ile kullanılır.

 

--dry-run

Hiçbir dosyada değişiklik yapmaksızın uygulanan yamaların sonuçları basılır.

 

-e, --ed

Yama dosyası bir ed betiği olarak yorumlanır.

 

-E, --remove-empty-files

Yama uygulandıktan sonra boşalan dosyalar silinir. Aslında, bu seçenek gereksizdir, çünkü patch yamadıktan sonra dosyanın varolup olmayacağını saptamak için başlıktaki tarih damgasını inceler. Buna rağmen, girdi bir bağlamsal fark dosyası değilse ya da patch POSIX uyumlu ise, patch bu seçenek verilmedikçe yamandıktan sonra boşalan dosyaları silmez. patch böyle bir dosyayı sildikten sonra boşalmışsa dosyanın bulunduğu dizini de silmeye çalışır.

 

-f, --force

Kullanıcının ne yaptığını tam olarak bildiği varsayılır ve kullanıcıya herhangi bir soru yöneltilmez. Hangi dosyaların yamanacağını belirtmeyen başlıklar içeren yamalar atlanır; Prereq: ile başlayan satırlarda yanlış sürüm bilgisi olsa bile dosya yamanır; eski ve yeni dosyaların yer değiştirilmesi gerekse bile yamaların bu işlem yapılmadan uygulanacağı varsayılır. Bu seçenek açıklamaları engellemez, bunun için -s seçeneğine bakınız.

 

-F sayı, --fuzz=sayı

En büyük belirsizlik faktörünü belirtmekte kullanılır. Bu seçenek sadece bağlamsal fark dosyalarına uygulanır ve patch yamanacak yeri bulurken yama olarak kullanılacak satırların baştan ve sondan bu kadarını yoksayar. Çok büyük belirsizlik faktörlerinin yamanın başarısızlığını arttıracağını unutmayın. Öntanımlı belirsizlik faktörü 2'dir ve bağlamsal fark dosyalarında bağlamsal satır sayısından daha yüksek bir değer (genelde 3'tür) atanmamalıdır.

 

-g sayı, --get=sayı

Bir dosya RCS veya SCCS denetimindeyken, böyle bir dosya yoksa veya salt-okunursa ya da öntanımlı sürümüyle eşleşiyorsa; veya ClearCase denetimindeyken, böyle bir dosya yoksa, bu seçenek, patch'in eylemlerini denetlemekte kullanılır. sayı pozitifse, patch dosyayı sürüm denetim sisteminden alır; sıfırsa, RCS, SCCS veya ClearCase yoksayılır ve dosya alınmaz; negatifse dosyanın alınıp alınmayacağı kullanıcıya sorulur. Bu seçeneğin öntanımlı değeri eğer atanmışsa, PATCH_GET ortam değişkeninden alınır; atanmamışsa ve patch POSIX uyumluysa öntanımlı değer sıfır, aksi takdirde negatiftir.

 

--help

Seçeneklerin bir özetini basar ve çıkar.

 

-i yamadosyası, --input=yamadosyası

Yama yamadosyası dosyasından okunur. yamadosyası olarak - verilmişse öntanımlı olarak standart girdi okunur.

 

-l, --ignore-whitespace

Yamanacak dosyaların içindeki sekmeler ve boşluklar için yama içindeki boşluklarla birebir eşleşme aranmaz, ancak herhangi bir uzunlukta boşluğun her iki dosyada da karşılıklı varlığı şarttır, satır sonlarındaki boşluklar eşleşme açısından yoksayılır. Normal karakterler tam olarak eşleştirilir. Bağlamsal her satır yamanacak dosyadaki satırlarla daima eşleştirilir.

 

-n, --normal

Yama dosyası normal bir yama dosyası olarak yorumlanır.

 

-N, --forward

Eski ve yeni dosyaların yer değiştirileceği görünen veya zaten uygulanmış yamalar yoksayılır. -R seçeneğine de bakınız.

 

-o çıktıdosyası, --output= çıktıdosyası

Dosyaların yerinde yamanması yerine çıktı, çıktıdosyası dosyasına gönderilir.

 

-p sayı, --strip=sayı

Yama dosyasında bulunan her dosya isminin başından sayı ile belirtilen sayıda bölü çizgisi içeren dizge yoksayılır. Birden fazla yanyana bölü çizgisi varsa bunlar tek bir bölü çizgisi sayılır. Yama dosyasının yamanacak dosyalardan farklı bir dizinde tutulması durumunda yamanacak dosyaların nasıl bulunacağını belirtmek amacıyla kullanılır. Örneğin, yama dosyasında yamanacak dosya isminin şöyle verildiğini varsayalım:

 

/u/howard/src/blurfl/blurfl.c

 

Seçenek -p0 olarak verilirse bu dizge olduğu gibi ele alınır, -p1 verilirse,

 

u/howard/src/blurfl/blurfl.c

 

baştaki bölü çizgisi atılır, -p4 verilirse,

 

blurfl/blurfl.c

 

olur. -p hiç belirtilmezse sonuç blurfl.c olacaktır. Bu durumda dosya yamanın bulunduğu dizinde aranacağından dosya daha farklı bir yerdeyse bu da -d seçeneği ile belirtilebilir.

 

--posix

POSIX standardına kesinlikle uyulur:

 

--quoting-style=sözcük

Çıktılanan isimler sarmalanırken sözcük ile belirtilen tarz kullanılır. sözcük şunlardan biri olabilir:

 

--quoting-style seçeneği için öntanımlı değeri QUOTING_STYLE ortam değişkeninde belirtebilirsiniz. Bu ortam değikeni atanmamışsa öntanımlı değer shell'dir.

 

-r reddosyası, --reject-file=reddosyası

Bu yamanın eski ve yeni dosyalar yer değiştirilerek uygulanacağı varsayılır. Yama olarak kullanılacak her bölümdeki eski ve yeni satırlar yer değiştirilerek uygulanmaya çalışılır. Yer değiştirildiğinde anlamsız olan kısımlar reddedilir. -R seçeneği ed fark betikleri ile çalışmaz, çünkü yer değiştirme işlemini gerçekleştirmek için çok az bilgi içerirler.

 

Yama içindeki kısımlardan ilkinin uygulanması başarısız olursa, patch bu kısmın eski ve yeni satırlarını yer değiştirerek böyle uygulanabiliyor mu diye bakar. Böyle uygulanabiliyorsa kullanıcıya -R seçeneğinin uygulanmasını isteyip istemediğini sorar. Uygulanamıyorsa, patch normal olarak uygulamaya devam eder. (Bilgi: Eğer yama bir normal yama ise ve boş bir içerik bile daima eşleşeceğinden ilk komut yamanın bir ek uygulanacağını belirtiyorsa bu yöntem yer değiştirmeli yamayı saptayamaz. Tesadüfen, çoğu yama bir satırın tamamen silinmesini değil ya bir ek ya da bir değişiklik yapılmasını gerektirir, bu durumda yer değiştirmeli normal fark dosyalarından silme işlemi ile başlayanlar başarıyı arttıran kuralların uygulanmasına bağlı olarak başarısız olur.)

 

-s, --silent, --quiet

Bir hata oluşmadıkça bilgilendirici hiçbir şey çıktılanmaz.

 

-t, --batch

-f seçeneğinde olduğu gibi sorular engellenir ama bu biraz farklı kabulllerle yapılır: başlıklarında dosya isimlerini içermeyen yamalar atlanır ( -f ile aynı); yamanın Prereq: satırında yanlış sürüm belirtilen dosyalar için yamalar atlanır; ve yer değiştirme uygulanması gerekliliği saptanan yamaların yer değiştirme ile uygulanacağı varsayılır.

 

-T, --set-time

Yamanmış dosyaların erişim ve değiştirme zamanları, bağlamsal fark dosyalarının başlıklarındaki zaman bilgisinin yerel zamanı gösterdiği varsayımıyla bu zamana ayarlanır. Bu seçeneğin kullanılması önerilmez, çünkü yerel zaman kullanılarak uygulanan yamaları diğer zaman dilimlerindeki kulanıcılar kolayca kullanamazlar, ayrıca yaz saati uygulamasından dolayı yerel zaman damgaları yamanın geçmişte uygulanması gibi tuhaflıklara sebep olabilir. Bu seçenek yerine -Z veya --set-utc seçeneklerini kullanarak zamanı UTC'ye göre belirtmeyi tercih edin.

 

-u, --unified

Yama dosyası birleşik bağlamsal fark dosyası olarak yorumlanır.

 

-v, --version

patch'in sürüm başlığını ve ama seviyesini basar ve çıkar.

 

-V yöntem, --version-control=yöntem

Yedek dosya isimleri saptanırken yöntem kullanılır. Bu yöntem ayrıca bu seçenek ile gerektiğinde değiştirilmek üzere PATCH_VERSION_CONTROL (veya bu atanmamışsa VERSION_CONTROL) ortam değişkeni ile atanabilir. Burada bir yöntemin atanması yedekleme yapılacağı anlamına gelmez, sadece yedekleme yapılacaksa yedek dosyalarının ismi bu yöntem kullanılarak saptanır.

 

yöntem değeri GNU Emacs'ın `version-control' değişkeni gibidir; farklı olarak patch daha açıklayıcı olan eşanlamlılarını da tanır. Geçerli yöntem değerleri şunlardır (eşsiz kısaltmalar da kabul edilir):

 

Numaralı ve basit yedeklemede dosya ismi çok uzun olursa bunlar yerine sonek olarak ~ kullanılır, bu işlem de dosya isminin çok uzun olmasına sebep oluyorsa dosya ismindeki son karakter ~ karakteri ile değiştirilir.

 

--verbose

Yapılan işlem hakkında daha ayrıntılı bilgi verilir.

 

-x sayı, --debug=sayı

Sadece patch yamacılarını ilgilendiren hata ayıklama seçeneklerini belirtmek için kullanılır.

 

-Y önek, --basename-prefix=önek

Basit yedek dosyası ismi oluşturulurken dizinlerden arındırılmış dosya isminin önüne önek getirilir. Örneğin basit yedek dosya ismi -Y .del/ ile belirtilmişse src/patch/util.c dosyasının ismi src/patch/.del/util.c yapılır.

 

-z sonek, --suffix=sonek

Basit yedek dosyası ismi oluşturulurken dosya isminin sonuna sonek getirilir. Örneğin basit yedek dosya ismi -z - ile belirtilmişse src/patch/util.c dosyasının ismi src/patch/util.c- yapılır. Yedekleme soneki gerektiğinde bu seçenek ile değiştirilmek üzere SIMPLE_BACKUP_SUFFIX ortam değişkeni ile de atanabilir.

 

-Z, --set-utc

Yamanmış dosyaların erişim ve değiştirme zamanları, bağlamsal fark dosyalarının başlıklarındaki zaman bilgisinin koordinatlı evrensel zamanı (UTC; GMT olarak da bilinir) gösterdiği varsayımıyla bu zamana ayarlanır. Ayrıca -T veya --set-time seçeneklerinin açıklamasına da bakınız.

 

Dosyanın orjinal zamanı yama başlığında belirtilen zamanla eşleşmezse ya da onun içeriği yama ile tam olarak eşleşmezse, -Z (--set-utc) ve -T ( --set-time) seçenekleri bir dosyanın zamanını ayarlamaktan kaçınır. Buna rağmen -f (--force) seçeneği belirtilmişse dosyanın zamanı ne olursa olsun ayarlanır.

 

diff çıktı biçiminin sınırlamalarından dolayı, dosyaları içeriği değiştirilmeyecekse, bu seçeneklerle bu dosyaların zamanı güncellenemez. Ayrıca, bu seçenekleri kullandığınız takdirde, zamanları güncellenmiş dosyalara bağımlı dosyaları kaldırmalısınız ( make clean gibi). Böylece sonraki make çağrılarında yamanmış dosyaların zamanlarından dolayı hatalarla/uyarılarla karşılaşmazsınız.

 

ORTAM DEĞİŞKENLERݶ

PATCH_GET

Eksik ya da salt-okunur dosyaların RCS, ClearCase veya SCCS'den öntanımlı olarak alınıp alınmayacağını belirtmek için kullanılır. -g (--get) seçeneğinin açıklamasına bakınız.

 

POSIXLY_CORRECT

Bu değişken atanmışsa patch öntanımlı olarak POSIX standardına uyumlu davranır. --posix seçeneğinin açıklamasına bakınız.

 

QUOTING_STYLE

--quoting-style seçeneğinin öntanımlı değeridir.

 

SIMPLE_BACKUP_SUFFIX

Bu ortam değişkeninin değeri basit yedekleme dosyalarında .orig soneki yerine kullanılacak sonektir.

 

TMPDIR, TMP, TEMP

Geçici dosyaları konulacağı dizindir. patch bu listeden atanmış değerlerden ilkinin değeri kullanır. Hiçbiri atanmamışsa sisteme bağlı öntanımlı değer kullanılır. Unix makinalar için bu değer normalde /tmp dizinidir.

 

VERSION_CONTROL, PATCH_VERSION_CONTROL

Sürüm denetim tarzını belirtir. -v ( --version-control) seçeneğinin açıklamasına bakınız.

 

İLGİLİ DOSYALAR¶

/dev/tty

denetim uçbirimi; kullanıcıya sorulan soruların yanıtlarını almak için kullanılır.

 

$TMPDIR/p*

geçici dosyalar

 

İLGİLİ BELGELER¶

YAMA GÖNDERENLER İÇİN¶

LC_ALL=C TZ=UTC0 diff -Naur gcc-2.7 gcc-2.8

diff -Naur v2.0.29/prog/README prog/README
--- v2.0.29/prog/README   Mon Mar 10 15:13:12 1997
+++ prog/README   Mon Mar 17 14:58:22 1997

diff -Naur v2.0.29/prog/README v2.0.30/prog/README
--- v2.0.29/prog/README   Mon Mar 10 15:13:12 1997
+++ v2.0.30/prog/README   Mon Mar 17 14:58:22 1997

TANI İLETİLERݶ

YETERSİZLİKLER¶

UYUMLULUK BİLGİLERݶ

·

Geleneksel patch'de -p seçeneğinin terimi isteğe bağlıdır. Yalnız başına -p seçeneği -p0'a eşdeğerdir. Şimdiki durumda ise -p seçeneğinin bir terime sahip olması zorunludur ve -p 0 seçeneği -p0 seçeneğine eşdeğerdir. En yüksek derecede uyumluluk adına seçeneği -p0 ve -p1 gibi kullanın.

 

Ayrıca, geleneksel patch dosya yolunu saptarken bölü çizgilerinin sayısına bakarken yeni sürümleri dosya yolunu oluşturan elemanların sayısına bakmaktadır. Bundan dolayı, birden fazla yanyana bölü çizgisi tek bir bölü çizgisi olarak ele alınmaktadır. En yüksek derecede uyumluluk adına gönderilen yamaların içindeki dosya isimlerinde // olmamasına dikkat edin.

 

·

Geleneksel patch'de yedekleme öntanımlı olarak etkindir. Bu davranış şimdi sadece -b (--backup) seçeneği ile etkin kılınabilmektedir.

 

Bunun tersine, POSIX patch'de bir eşleşmeme olsa bile yedekleme asla yapılmaz. GNU patch'de bu davranış --posix seçeneği kullanılarak yahut POSIXLY_CORRECT ortam değişkeninin varlığı sayesinde POSIX uyumluluğu sağlanarak aksi takdirde --no-backup-if-mismatch seçeneği ile etkinleştirilir.

 

Geleneksel patch'in -b sonek seçeneği ile GNU patch'in -b -z sonek seçenekleri eşdeğerdir.

 

·

Geleneksel patch yama başlığından yamanacak dosyanın ismini öğrenmek için karmaşık (ve iyi belgelenmemiş) bir yöntem kullanır. Bu yöntem POSIX ile uyumlu olmadığı gibi, birkaç yanlış gibi görünmeyen yanlış içerir. Şimdi patch aynı karmaşıklıkta (ama daha iyi belgelenmiş) ve isteğe bağlı olarak POSIX uyumlu olabilen bir yöntem kullanmaktadır; onun artık daha az yanlış gibi görünmeyen yanlış içerdiğini düşünüyoruz. Bağlamsal fark dosyasının başlığında ve Index: satırında dosya isimlerinden önek ayırması yapıldıktan sonra kalan dosya isimleri aynı ise bu iki yöntem birbiriyle uyumludur. Yamanız, her başlıktaki dosya isimleri eşit sayıda bölü çizgisi içeriyorsa, normal olarak uyumludur.

 

·

Geleneksel patch kullanıcıya bir soru yönelteceği zaman soruyu standart hataya gönderir ve yanıtı bir uçbirim olarak sırayla şu dosyalarda arar: standart hata, standart çıktı, /dev/tty ve standard girdi. Şimdi ise patch soruyu standart çıtıya gönderip yanıtı /dev/tty'den okur. Bazı soruların öntanımlı yanıtları değiştirilmiştir, böyle öntanımlı yanıtları olan sorularda patch artık sonsuz bir döngüye girip yanıt beklememektedir.

 

·

Geleneksel patch gerçek bir hata durumunda 1 ile dönerken, uygulanamayan yamalar olduğunda bunların sayısını belirten bir çıkış değeri ile döner. Şimdi ise patch uygulanamayan yamalar olduğunda 1 ile, gerçek bir sorun olması durumunda 2 çıkış değeri ile döner.

 

·

GNU patch, geleneksel patch ve POSIX uyumlu patch için ortak olan seçeneklerle kendinizi sınırlarsanız iyi olur. Bu seçenekler aşağıda listelenmiştir. Terimli seçeneklerde terimler zorunludur ve terim ile seçenek arasındaki boşluğun olup olmaması önemlidir.

 

-c
-d dizin
-D tanım
-e
-l
-n
-N
-o çıktıdosyası
-psayı
-R
-r reddosyası

YAZILIM HATALARI¶

KOPYALAMA¶

COPYING¶

YAZARLAR¶

ÇEVİREN¶