Sözdizimi
getconf -a [dosya]
getconf [-v ortam] yol_degiskeni dosya
getconf [-v ortam] sistem_degiskeni
Açıklama
getconf aracı, POSIX veya X/Open yol veya sistem yapılandırma değişkenlerinin değerlerini standart çıktıya (stdout) yazdırır. Bir değişken tanımlanmamışsa, çıktı olarak “undefined” (tanımsız) dizesi yazdırılır.
Komutun ilk biçimi, tüm yol veya sistem yapılandırma değişkenlerini standart çıktıya görüntüler. Eğer dosya belirtilmişse, tüm yol yapılandırma değişkenleri pathconf(2) kullanılarak dosya için bildirilir. Aksi takdirde, confstr(3) ve sysconf(3) kullanılarak tüm sistem yapılandırma değişkenleri bildirilir.
Komutun iki zorunlu argümana sahip ikinci biçimi, pathconf(2) kullanarak dosyaya ve dosya sistemine özel yapılandırma değişkenlerini getirir. Tek bir argümana sahip üçüncü biçim ise değişkenin türüne bağlı olarak confstr(3) ve sysconf(3) kullanarak sistem yapılandırma değişkenlerini getirir. Bir uzantı olarak, ikinci biçim <limits.h> içindeki statik sınırları sorgulamak için de kullanılabilir.
Tüm sysconf(3) and pathconf(2) değişkenleri, ilgili standart C dili bağlamalarında (bindings) tanımlanan manifest sabitleriyle aynı adı (başlarındaki alt çizgi veya ön ekler dahil) kullanır. Yani sistem_degiskeni, sysconf(3) adları olan _SC_ARG_MAX veya _SC_POSIX_VERSION yerine ARG_MAX veya _POSIX_VERSION olabilir. confstr(3) fonksiyonundan getirilen değişkenlerin başındaki ‘CS’ kısmı atılır; böylece _CS_PATH, bir sistem_degiskeni olan “PATH” ile sorgulanır.
Programlama Ortamları
-v ortam seçeneği, değerlerin sorgulanacağı IEEE Std 1003.1-2001 (“POSIX.1”) programlama ortamını belirtir. Bu seçenek şu an için hiçbir şey yapmaz, ancak gelecekte her ikisini de destekleyen platformlarda 32-bit ve 64-bit yürütme ortamları arasında seçim yapmak için kullanılabilir. Mevcut yürütme platformunda desteklenmeyen bir ortam belirtilmesi tanımsız sonuçlar verir.
Standart programlama ortamları şunlardır:
POSIX_V6_ILP32_OFF32 Tam olarak 32-bit tamsayı (integer), long, işaretçi (pointer) ve dosya ofseti (file offset). Desteklenen platformlar: Yok.
POSIX_V6_ILP32_OFFBIG Tam olarak 32-bit tamsayı, long ve işaretçi; en az 64-bit dosya ofseti. Desteklenen platformlar: IA32, PowerPC.
POSIX_V6_LP64_OFF64 Tam olarak 32-bit tamsayı; tam olarak 64-bit long, işaretçi ve dosya ofseti. Desteklenen platformlar: AMD64, SPARC64.
POSIX_V6_LPBIG_OFFBIG En az 32-bit tamsayı; en az 64-bit long, işaretçi ve dosya ofseti. Desteklenen platformlar: Yok.
Şu komut:
getconf POSIX_V6_WIDTH_RESTRICTED_ENVS
bazı temel türlerin genişliğinin yerel C türü olan long'un genişliğinden daha büyük olmadığı ortamların yeni satırla ayrılmış bir listesini döndürür. Şu anda FreeBSD tarafından desteklenen tüm programlama ortamları bu özelliğe sahiptir. confstr(3) değişkenlerinden bazıları, yukarıda açıklanan standart programlama ortamlarını kullanmak için gerekli derleyici ve bağlayıcı (linker) bayrakları hakkında bilgi sağlar.
Bu değerlerin birçoğu sysctl(8) mekanizması aracılığıyla da edinilebilir.
Çıkış Durumu
getconf aracı başarı durumunda 0, bir hata oluşursa >0 değeriyle çıkar.
Örnekler
Şu komut:
getconf PATH
PATH çevre değişkeni için sistem varsayılan ayarını görüntüleyecektir.
Şu komut:
getconf NAME_MAX /tmp
/tmp dizinindeki bir dosya adının maksimum uzunluğunu görüntüleyecektir.
Şu komut:
getconf -v POSIX_V6_LPBIG_OFFBIG LONG_MAX
eğer sistem bu ortamı destekliyorsa, POSIX_V6_LPBIG_OFFBIG programlama ortamında C türü olan long'un maksimum değerini görüntüleyecektir.
Teşhisler
Tamamen bilinmeyen bir sistem_degiskeni veya yol_degiskeni kullanımı bir hata olarak kabul edilir ve standart hataya (stderr) teşhis amaçlı bir mesaj yazılmasına neden olur. Bilinen ancak yalnızca tanımlanmamış olan bir değişken ise hata göstergesine yol açmaz. getconf aracı, IEEE Std 1003.1-2001 (“POSIX.1”) için tanımlanmış olan tüm değişkenleri, şu anda uygulanmamış olanlar da dahil olmak üzere tanır.
Ayrıca Bakınız
pathconf(2), confstr(3), sysconf(3), sysctl(8)
Standartlar
getconf aracının IEEE Std 1003.1-2001 (“POSIX.1”) standardı ile uyumlu olması beklenmektedir.
Geçmiş
getconf aracı ilk olarak FreeBSD 5.0'da görünmüştür.
Yazarlar
Garrett A. Wollman wollman@lcs.mit.edu
macOS 26.4 15 Eylül 2017 macOS 26.4