Özet
tput [-Ttype] capname [parms ... ]
tput [-Ttype] init
tput [-Ttype] reset
tput [-Ttype] longname
tput -S <<
tput -V
Açıklama
tput aracı, terminale bağlı özelliklerin (capabilities) ve bilgilerin değerlerini kabuğun (bkz. sh(1)) kullanımına sunmak, terminali başlatmak (initialize) veya sıfırlamak (reset) ya da talep edilen terminal türünün uzun adını döndürmek için terminfo veritabanını kullanır. Sonuç, özelliğin türüne bağlıdır:
string tput dizeyi standart çıktıya yazar. Sona yeni satır karakteri eklenmez.
integer tput ondalık değeri standart çıktıya yazar ve sonuna yeni bir satır karakteri ekler.
boolean tput yalnızca çıkış kodunu ayarlar (eğer terminal bu özelliğe sahipse DOĞRU için 0, sahip değilse YANLIŞ için 1) ve standart çıktıya hiçbir şey yazmaz.
Uygulama, standart çıktıda döndürülen bir değeri kullanmadan önce, değerin 0 olduğundan emin olmak için çıkış kodunu (örneğin, $?, bkz. sh(1)) test etmelidir. (ÇIKIŞ KODLARI ve TEŞHİSLER bölümlerine bakın.) Özelliklerin tam listesi ve her biriyle ilişkili capname için terminfo(5) kılavuzuna bakın.
-Ttype terminalin türünü belirtir.: Normalde bu seçenek gereksizdir, çünkü varsayılan değer TERM çevre değişkeninden alınır. Eğer -T belirtilirse, LINES ve COLUMNS kabuk değişkenleri de yoksayılacaktır.
capname terminfo veritabanındaki özelliği belirtir. termcap desteği derlendiğinde, özellik için termcap adı da kabul edilir.
parms Eğer özellik parametre alan bir dize ise, parms argümanları dize içine yerleştirilecektir.
Parametrelerin çoğu sayılardan oluşur. Yalnızca birkaç terminfo özelliği dize parametreleri gerektirir; tput hangilerinin dize olarak aktarılacağına karar vermek için bir tablo kullanır. Normalde tput, yer değiştirme (substitution) işlemini gerçekleştirmek için tparm (3X) kullanır. Özellik için hiçbir parametre verilmezse tput, yer değiştirme işlemini yapmadan dizeyi yazar.
-S: tek bir tput çağrısında birden fazla özelliğin işlenmesine olanak tanır. Özellikler, komut satırı yerine standart girdiden tput'a aktarılmalıdır (örneğe bakın). Her satırda yalnızca bir adet capname olmasına izin verilir. -S seçeneği, 0 ve 1 olan boolean ve dize çıkış kodlarının anlamını değiştirir (ÇIKIŞ KODLARI bölümüne bakın).
tput, tparm (3X) kullanıp kullanmayacağına ve parametreleri nasıl yorumlayacağına karar vermek için yine bir tablo ve girdisindeki parametrelerin varlığını kullanır.
-V: bu programda kullanılan ncurses sürümünü bildirir ve çıkar.
init Eğer terminfo veritabanı mevcutsa ve kullanıcının terminali için bir girdi varsa (yukarıdaki -Ttype seçeneğine bakın), şunlar gerçekleşir:
(1) eğer varsa, terminalin başlatma (initialization) dizeleri, terminfo(5) kılavuzunun Sekmeler ve Başlatma (Tabs and Initialization) bölümünde açıklandığı şekilde çıktı olarak verilecektir,
(2) girdide belirtilen tüm gecikmeler (örneğin yeni satır) tty sürücüsünde ayarlanacaktır,
(3) sekmelerin genişletilmesi (tabs expansion), girdideki belirtimlere göre etkinleştirilecek veya devre dışı bırakılacaktır, ve
(4) sekmeler genişletilmezse, standart sekmeler ayarlanacaktır (her 8 boşlukta bir).
Eğer bir girdi yukarıdaki dört eylemden herhangi biri için gerekli bilgileri içermiyorsa, o eylem sessizce atlanacaktır.
reset Başlatma dizelerini çıktı vermek yerine, eğer varsa terminalin sıfırlama (reset) dizeleri çıktı verilecektir (rs1, rs2, rs3, rf). Sıfırlama dizeleri mevcut değilse ancak başlatma dizeleri mevcutsa, başlatma dizeleri çıktı verilecektir. Aksi takdirde, reset eylemi init ile tamamen aynı şekilde çalışır.
longname Eğer terminfo veritabanı mevcutsa ve kullanıcının terminali için bir girdi varsa (yukarıdaki -Ttype seçeneğine bakın), terminalin uzun adı çıktı verilecektir. Uzun ad, terminfo veritabanındaki terminal tanımının ilk satırındaki son addır [bkz. term(5)].
Eğer tput, reset adında bir bağlantı (link) ile çağrılırsa, bu tput reset ile aynı etkiye sahip olur. Benzer davranış gösteren karşılaştırma için @TSET@ sayfasına bakın.
Örnekler
tput init
Terminali TERM çevre değişkenindeki terminal türüne göre başlatır. Bu komut, profile(5) kılavuz sayfasında örneklendiği gibi, TERM çevre değişkeni dışa aktarıldıktan sonra herkesin .profile dosyasına dahil edilmelidir.
tput -T5620 reset
TERM çevre değişkenindeki terminal türünü geçersiz kılarak bir AT&T 5620 terminalini sıfırlar.
tput cup 0 0
İmleci 0. satıra, 0. sütuna (ekranın sol üst köşesi, genellikle imlecin "home" konumu olarak bilinir) taşımak için gereken diziyi gönderir.
tput clear
Geçerli terminal için ekranı temizleme (clear-screen) dizisini yansıtır.
tput cols
Geçerli terminalin sütun sayısını yazdırır.
tput -T450 cols
450 terminalinin sütun sayısını yazdırır.
bold=`tput smso` offbold=`@TPUT@ rmso`
Geçerli terminal için dikkat çekme (stand-out) modu dizisini başlatmak üzere bold, ve bu modu sonlandırmak üzere offbold kabuk değişkenlerini ayarlar. Bunu bir komut istemi takip edebilir:
echo "${bold}Please type in your name: ${offbold}\c"
tput hc
Geçerli terminalin basılı kopya (hard copy) terminali olup olmadığını belirtmek için çıkış kodunu ayarlar.
tput cup 23 4
İmleci 23. satıra, 4. sütuna taşımak için gereken diziyi gönderir.
tput cup
Hiçbir parametre yer değiştirmeden imleç hareketi için olan terminfo dizesini gönderir.
tput longname
TERM çevre değişkeninde belirtilen terminal türü için terminfo veritabanındaki uzun adı yazdırır.
tput -S <<!
> clear
> cup 10 10
> bold
> !
Bu örnek, tput'un tek bir çağrıda birkaç özelliği işlediğini gösterir. Ekranı temizler, imleci 10, 10 konumuna taşır ve kalın (ekstra parlak) modu açar. Liste, kendi başına bir satırda bulunan bir ünlem işareti (!) ile sonlandırılır.
Dosyalar
/usr/share/terminfo derlenmiş terminal tanımlama veritabanı
/usr/share/tabset/* bazı terminaller için terminale çıktı verilmeye uygun biçimdeki sekme (tab) ayarları (kenar boşluklarını ve sekmeleri ayarlayan kaçış dizileri/escape sequences); daha fazla bilgi için terminfo(5) kılavuzunun "Sekmeler ve Başlatma" (Tabs and Initialization) bölümüne bakın
Çıkış Kodları
Eğer -S seçeneği kullanılırsa tput, her satırdaki hataları kontrol eder ve herhangi bir hata bulunursa, çıkış kodunu 4 artı hatalı satır sayısı olarak ayarlar. Hata bulunamazsa çıkış kodu 0 olur. Hangi satırın başarısız olduğuna dair hiçbir bilgi verilemez, bu nedenle çıkış kodu 1 asla görünmez. Çıkış kodları 2, 3 ve 4 olağan yorumlarını korur. Eğer -S seçeneği kullanılmazsa, çıkış kodu capname'in türüne bağlıdır:
boolean DOĞRU için 0 ve YANLIŞ için 1 değeri ayarlanır.
string eğer capname bu terminal türü için tanımlanmışsa 0 değeri ayarlanır (capname değeri standart çıktıya döndürülür); eğer capname bu terminal türü için tanımlanmamışsa 1 değeri ayarlanır (standart çıktıya hiçbir şey yazılmaz).
integer capname bu terminal türü için tanımlanmış olsun ya da olmasın, her zaman 0 değeri ayarlanır. capname'in bu terminal türü için tanımlanıp tanımlanmadığını belirlemek için kullanıcı standart çıktıya yazılan değeri test etmelidir. -1 değeri, capname'in bu terminal türü için tanımlanmadığı anlamına gelir.
other reset veya init ilgili dosyalarını bulmada başarısız olabilir. Bu durumda çıkış kodu 4 + errno olarak ayarlanır.
Diğer tüm çıkış kodları bir hataya işaret eder; TEŞHİSLER bölümüne bakın.
Teşhisler
tput aşağıdaki hata mesajlarını yazdırır ve ilgili çıkış kodlarını ayarlar.
çıkış kodu hata mesajı ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 0 (capname, bu terminal türü için terminfo(5) veritabanında belirtilmemiş sayısal bir değişkendir, örn. tput -T450 lines ve @TPUT@ -T2621 xmc) 1 hata mesajı yazdırılmaz, ÇIKIŞ KODLARI bölümüne bakın. 2 kullanım hatası 3 bilinmeyen terminal türü veya terminfo veritabanı yok 4 bilinmeyen terminfo özelliği capname
4 -S içinde hata oluştu ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Taşınabilirlik
longname ve -S seçenekleri ile cup örneğinde kullanılan parametre yer değiştirme özellikleri, BSD curses veya SVr4 öncesindeki AT&T/USL curses sürümlerinde desteklenmez.
X/Open yalnızca clear, init ve reset işlenenlerini (operands) belgeler. Bu gerçeklemede, clear özelliği capname desteğinin bir parçasıdır. Solaris, IRIX64 ve HPUX gibi SVr4 tabanlı sistemlerin yanı sıra AIX ve Tru64 gibi diğer sistemlerdeki tput gerçeklemeleri de capname işlenenleri için destek sağlar.
FreeBSD ve NetBSD gibi birkaç platform, ilgili tput komutlarında terminfo özellik adları yerine termcap adlarını tanır.
Capname işlenenleri için destek sağlayan çoğu gerçekleme, içindeki parametreleri genişletmek için tparm işlevini kullanır. Bu işlev, tput'un hangi türü kullanacağını bilmesini gerektiren sayısal ve dize parametrelerinin bir karışımını bekler. Bu gerçekleme, standart capname işlenenleri için bunu belirlemek üzere bir tablo, standart dışı capname işlenenlerini analiz etmek için ise dahili bir kütüphane işlevi kullanır. Diğer gerçeklemeler, yalnızca rakam içeren bir işlenenin sayı olmasının amaçlandığını tahmin edebilir.
Ayrıca Bakınız
clear(1), stty(1), tabs(1), terminfo(5), curs_termcap(3X).
Bu belge ncurses sürüm 5.7'yi (yama 20081102) açıklamaktadır.
tput(1)