dsymutil

Synopsis

       dsymutil [options] executable

Description

dsymutil, bir yürütülebilir dosyanın (executable) sembol tablosunda yer alan hata ayıklama sembolleri bilgilerini kullanarak, nesne dosyalarında (object files) bulunan DWARF hata ayıklama bilgilerini bağlar (link). Varsayılan olarak, bağlanan hata ayıklama bilgisi, yürütülebilir dosyayla aynı ada sahip bir .dSYM paketi (bundle) içine yerleştirilir.

Options

--accelerator=<hızlandırıcı türü> İstenen hızlandırıcı tablosu (accelerator table) türünü belirtin. Geçerli seçenekler 'Apple', 'Dwarf', 'Default' ve 'None'dır.

--arch DWARF hata ayıklama bilgilerini yalnızca belirtilen CPU mimari türleri için bağlayın. Mimariler adlarıyla belirtilebilir. Bu seçenek kullanıldığında, herhangi bir mimari düzgün şekilde bağlanamazsa bir hata döndürülür. Bu seçenek, istenen her mimari için bir kez olmak üzere birden fazla kez belirtilebilir. Varsayılan olarak tüm CPU mimarileri bağlanacaktır ve düzgün bağlanamayan herhangi bir mimari dsymutil'in hata döndürmesine neden olacaktır.

--build-variant-suffix <sonek=yapı_varyantı> Yürütülebilir dosyayı oluşturmak için kullanılan yapı varyantı sonekini (build variant suffix) belirtin. Bir ürünün ikili dosyası (binary) için her biri biraz farklı şekilde oluşturulmuş birden fazla varyant olabilir. En yaygın yapı varyantları 'debug' ve 'profile'dır. DYLD_IMAGE_SUFFIX ortam değişkeninin ayarlanması, dyld'nin çalışma zamanında belirtilen varyantı yüklemesine neden olur.

--cas dsymutil'in hata ayıklama bilgisindeki CASID dosya yollarını çözümlemek için kullanabileceği içerik adreslenebilir depolama (content addressable storage - CAS) yolunu belirtin.

--cas-plugin-path Kullanılıyorsa CAS eklentisi dylib yolunu belirtin.

--cas-plugin-option <cas seçeneği> Gerekirse CAS eklentisi dylib'ine geçirilecek seçenekleri belirtin.

--dump-debug-map Yürütülebilir dosyanın hata ayıklama haritasını (debug-map - hata ayıklama bilgilerini içeren nesne dosyalarının listesi) YAML biçiminde dökün (dump) ve çıkın. DWARF bağlama (link) işlemi gerçekleşmeyecektir.

-D

Aranacak dSYM dosyalarını içeren bir dizin belirtin. Bu, birleştirilebilir kütüphaneler (mergeable libraries) için kullanılır; böylece dsymutil, bu kütüphanelerde bulunan semboller hakkında hata ayıklama bilgisi içeren dSYM dosyalarını nerede arayacağını bilir.

--fat64 Universal ikilileri yayınlarken 64 bitlik bir başlık (header) kullanın.

--flat, -f Düz (flat) bir dSYM dosyası üretin. Çıktı dosyası -o seçeneği kullanılarak belirtilmediği sürece yürütülebilir dosya adının sonuna .dwarf uzantısı eklenecektir.

--gen-reproducer Girdi nesne dosyalarından oluşan bir yeniden üretici (reproducer) oluşturun. --reproducer=GenerateOnExit için takma addır.

--help, -h Bu yardım çıktısını yazdırın.

--keep-function-for-static Statik bir değişkenin, normalde ihmal edilecek olsa bile, kapsayan fonksiyonu korumasını sağlayın.

--minimize, -z Bir dSYM dosyası oluştururken kullanıldığında bu seçenek; dsymutil'in şu anda daha iyi alternatifleri (.apple_names ve .apple_types) olduğu için .debug_inlines, .debug_pubnames ve .debug_pubtypes bölümlerinin yayınlanmasını bastırır. --update seçeneğiyle birlikte kullanıldığında bu seçenek, gereksiz hızlandırıcı tablolarının kaldırılmasına neden olur.

--no-object-timestamp Nesne dosyaları için zaman damgasını (timestamp) kontrol etmeyin.

--no-odr C++ türlerini tekilleştirmek (uniquing) için ODR (One Definition Rule) kullanmayın.

--no-output Bağlama işlemini bellekte gerçekleştirin ancak sonuç dosyasını yayınlamayın.

--no-swiftmodule-timestamp swiftmodule dosyaları için zaman damgasını kontrol etmeyin.

--num-threads <iş_parçacığı>, -j <iş_parçacığı> Birden fazla mimariyi bağlarken kullanılacak maksimum eşzamanlı iş parçacığı (thread) sayısını (n) belirtir.

--object-prefix-map <önek=yeniden_eşlenmiş> İşlemeden önce nesne dosyası yollarını (ancak kaynak yollarını değil) yeniden eşleyin (remap). Bunu, modül önbelleği konumunun -fdebug-prefix-map kullanılarak yeniden eşlendiği Clang nesneleri için dsymutil'in Clang modül önbelleğini bulmasına yardımcı olmak amacıyla kullanın.

--oso-prepend-path Tüm hata ayıklama sembolü nesne dosyası yollarının başına eklenecek bir yol belirtir.

--out <dosya_adı>, -o <dosya_adı> dSYM paketini yerleştirmek için alternatif bir yol belirtir. Varsayılan dSYM paketi yolu, yürütülebilir dosya adına .dSYM eklenerek oluşturulur.

-q, --quiet Sessiz modu etkinleştirin ve çıktıyı sınırlayın.

--remarks-drop-without-debug Geçerli hata ayıklama konumları olmayan açıklamaları (remarks) atın. Bu bayrak olmadan tüm açıklamalar korunur.

--remarks-output-format <biçim> Bağlantılı açıklamalar serileştirilirken kullanılacak biçimi belirtin.

--remarks-prepend-path Harici açıklama dosyalarının yollarının başına eklenecek bir dizin belirtin.

--reproducer Yeniden üretici (reproducer) oluşturma modunu belirtin. Geçerli seçenekler 'GenerateOnExit', 'GenerateOnCrash', 'Use' ve 'Off'tur.

--statistics Her bir nesne dosyasının bağlanan hata ayıklama bilgisine katkısı hakkında istatistikleri yazdırın. Bu, bağlama işleminden sonra nesne dosyası adı, nesne dosyasındaki hata ayıklama bilgisinin boyutu (bayt cinsinden) ve bağlanan dSYM'ye katkıda olunulan boyutu (bayt cinsinden) içeren bir tablo yazdırır. Tablo çıktı boyutuna göre sıralanır ve en büyük katkıya sahip nesne dosyaları ilk sırada listelenir.

-s, --symtab Yürütülebilir dosyada veya nesne dosyalarında bulunan sembol tablosunu döker (dump) ve çıkar.

• -S: İkili bir dSYM eşlik dosyası yerine metinsel derleme dili (assembly) çıktısı verin.

--toolchain <araç_zinciri> Araç zincirini (toolchain) dSYM paketinin özellik listesine (plist) gömün.

-u, --update Mevcut bir dSYM dosyasını en son hızlandırıcı tablolarını ve diğer DWARF optimizasyonlarını içerecek şekilde güncelleyin. Bu seçenek '.apple_names' ve '.apple_types' özetlenmiş (hashed) hızlandırıcı tablolarını yeniden derler.

--use-reproducer Verilen yeniden üretici yolundaki nesne dosyalarını kullanın. --reproducer=Use için takma addır.

--verbose Bağlama sırasında ayrıntılı bilgi görüntüleyin.

--verify Bağlanan DWARF hata ayıklama bilgisi üzerinde DWARF doğrulayıcısını çalıştırın.

-v, --version Aracın sürümünü görüntüleyin.

• -y: Yürütülebilir dosyayı, bir yürütülebilir dosya yerine bir YAML hata ayıklama haritası (debug-map) olarak ele alın.

Çıkış Durumu

dsymutil, DWARF hata ayıklama bilgileri başarıyla bağlandıysa 0 döndürür. Aksi takdirde 1 döndürür.

Ayrıca Bkz.

llvm-dwarfdump(1)

Yazar

LLVM Ekibi tarafından sürdürülmektedir (https://llvm.org/).

Telif Hakkı

2003-2026, LLVM Project

11 2026-02-13 DSYMUTIL(1)