Bu, Ubuntu Online, Fedora Online, Windows çevrimiçi emülatörü veya MAC OS çevrimiçi emülatörü gibi birden fazla ücretsiz çevrimiçi iş istasyonumuzdan birini kullanarak OnWorks ücretsiz barındırma sağlayıcısında çalıştırılabilen icheck komutudur.
Program:
ADI
icheck - C arayüzü ABI/API denetleyicisi
SİNOPSİS
Kontrol -- canonify [[--temel DOSYA] ...] [SEÇENEKLER] [GCC_OPTIONS] [--] Dosyaları
Kontrol --karşılaştırmak [SEÇENEKLER] eski_dosya yeni dosya
AÇIKLAMA
API ve ABI değişiklikleri için C arayüzlerini statik olarak kontrol etmek için bir araç. Yazılacak tüm değişiklikler
ABI değişikliklerine neden olabilecek bildirimler, çoğu API değişikliğiyle birlikte algılanmalıdır.
icheck, ABI kaymasını önleme yöntemi olarak kitaplıklarla kullanılmak üzere tasarlanmıştır.
KOMUTLAR
Bir dizi kaynak dosyayı --canonify ile kurallı bir arabirim dosyasına dönüştürün, ardından karşılaştırın
--compare ile bu tür iki arabirim dosyası. Aralarında arayüz değişiklikleri varsa,
icheck değişiklikleri açıklayacak ve başarısız olacaktır.
-- canonify [[--temel DOSYA] ...] [SEÇENEKLER] [GCC_OPTIONS] [--] Dosyaları
Kaynak kodu dosyalarını (tipik olarak .h üstbilgileri) daha sonra karşılaştırılacak şekilde kurallaştırın
--karşılaştırmak. Genellikle ile kullanılır -o Özeti bir dosyaya kaydetme seçeneği.
--karşılaştırmak [SEÇENEKLER] eski_dosya yeni dosya
İle oluşturulan iki kurallı arabirim dosyasını okur -- canonify ve karşılaştırır
Uygulama Genel Arayüzündeki değişikliklere kaynak kodun yapısı
(geliştirici arayüzü veya API) ve kullanılan Uygulama İkili Arayüzü (ABI)
diğer programlara veya kitaplıklara karşı bağlantı.
SEÇENEKLER
KONTROL ET SEÇENEKLER
-o, --çıktı DOSYA
Çıktıyı stdout yerine FILE'a yayar.
- hata ayıklama N
Hata ayıklama bilgilerini boşaltın.
--bir tek ŞEY
Yalnızca verilen ŞEY'i işleyin.
--atla DOSYA
Gereksiz şeyleri atla DOSYA.
--yeniden-atla regexp
Normal ifadeyle eşleşen dosyalardan gereksiz şeyleri atlayın.
--sadece buradan DOSYA
Sadece bir şeyler al DOSYA.
--sadece-yeniden regexp
Yalnızca normal ifadeyle eşleşen dosyalardan bir şeyler alın.
GCC_OPTIONS
GCC_OPTIONS, gcc -E'ye aktarılır
YARDIM ET SEÇENEKLER
--yardım et
Şunun için yardım özetini görüntüleyin: Kontrol.
ÖRNEKLER
Tüm kaynak dosyalar gcc ile önceden işlenir, bu nedenle canonify'ın aynı içerme bilgilerine ihtiyacı vardır
kaynak kodu olarak - -I seçeneklerini eklemek için Makefile'deki sözdizimini izleyin cpp (Ya da
gcc) böylece gerekli tüm başlıklar bulunabilir. Kontrol gerekirse iptal edecek
başlıklar bulunamıyor. Kaynak derlenebilir olmalıdır; icheck hangi dosyaları işleyemez?
doğrudan derlenemez. Bir başlık eksikse #include ifadeleri veya başka türlü
özel bir şekilde kullanılmasını gerektiriyorsa, icheck ile doğrudan işlenemez.
Bunun yerine, işleri uygun şekilde ayarlayan bir saplama C dosyası yazın ve ardından #içeren
başlık.
Kontrol -- canonify -o ~/icheck/eski sürüm -I/usr/include/foo-2.0 /usr/src/bar/src/foobar.h
foobar.h dosyasının ve içerdiği tüm dosyaların bir metin özetini hazırlayın. özet
yazıldı ~/icheck/eski sürüm. için tekrarla /usr/src/bar1/src/foobar.h - aynı dosya
daha yeni kaynak dizinde, yeni bir dosyaya çıktı verme, örn. ~/icheck/yeni sürüm.
Kontrol --karşılaştırmak -o ~/icheck/results.txt ~/icheck/eski sürüm ~/icheck/yeni sürüm
İki özet dosyasının karşılaştırmasının raporunu yazar. Rapor, tüm
karşılaştırma sırasında bulunan ABI ve/veya API'deki değişiklikler.
Kontrol -- canonify -o debian/icheck.canonical -Idebian/foo-dev/usr/include debian/foo-
dev/usr/include/foobar.h
Kontrol --karşılaştırmak debian/icheck.manifest debian/icheck.canonical
Bu iki ifade, bir debian/kurallar dosyası, paketin oluşturulmasına neden olur
API veya ABI beklenmedik şekillerde değiştiyse başarısız olur, burada icheck.manifest bir kopyasıdır
pakete dahil olan beklenen arayüz.
--compare argümanlarının kendilerinin önceden işlenmiş geçerli C dosyaları olduğunu unutmayın.
bu nedenle icheck.manifest, C önişlemci mantığını içerebilir. Bu, bir paket
ana bilgisayar mimarisine bağlı olarak farklı arabirimleri dışa aktarır. Bu durumda, yapamazsınız
arayüz değiştiğinde ve bunu yapmanız gerektiğinde yeni bir icheck.canonical kopyasıyla değiştirin.
manifest'i güncelleyin. Manifest'in tamamını elle güncellemek yerine, el-
tek dosyada yazılı arayüz açıklamaları (icheck.static-manifest) ve ardından şunu kullanın:
Kontrol -- canonify --temel debian/icheck.static-manifest -o debian/icheck.dinamik-
apaçık
Son olarak, aşağıdakileri içeren icheck.manifest oluşturun:
#include "icheck.static-manifest"
#include "icheck.dynamic-manifest"
Bu, bildirimin bazı bölümlerini elle güncellemenize izin verirken, yine de otomatik olarak
geri kalanını üretmek.
ÇIKTI
icheck, türe bağlı olarak her olası API veya ABI değişikliğinin uzun bir açıklamasını oluşturur
bilgi. Gerçek program kodunu araştırmaz ve bu nedenle
algıladığı bazı tür değişiklikleri gerçek ABI veya API değişiklikleri değildir. Ancak bu normalde
yalnızca program kodu bunun için açıkça yazıldığında gerçekleşir. Şüpheniz varsa, varsayalım
değişti.
Sonunda, icheck değişikliklerin bir özetini sunar. Buradaki talimatların
--compare için argümanların sırasına bağlı olarak: eski arayüz önce gelmelidir,
ya da yönler tam tersi olacak. Çeşitli terimlerin anlamları şu şekildedir:
aşağıdaki gibidir:
ABI ABI, işler aşağıdakilerin bir sürümüne karşı derlenirse uyumludur.
arayüz, diğer sürüm kullanılarak çalıştırıldığında çalışacaktır.
API, eğer şeyler, API'nin bir sürümüne karşı derlenirse uyumludur.
arabirim diğerine karşı derlenebilir.
ileriye dönük uyumlu
Eskiye karşı derlenen şeyler varsa, bir arayüz ileriye dönük uyumludur.
sürüm yeni ile çalışacaktır. Bunun için önemli özellik sonam
değişir.
geriye doğru uyumlu
Bir arayüz, yeniye karşı derlenmişse geriye dönük olarak uyumludur.
sürüm eski ile çalışacaktır. Bunun için önemli özellik shlib'ler
versiyon değişir. Debian paketleri oluşturmuyorsanız, muhtemelen yapmazsınız.
geriye dönük uyumlu olmayan değişiklikleri önemseyin.
onworks.net hizmetlerini kullanarak icheck'i çevrimiçi kullanın
