AÇIKLAMA

system() kütüphane işlevi, aşağıdaki gibi exec(3) kullanarak belirtilen kabuk komutunu yürüten bir alt süreç oluşturmak için fork(2) çağrısını kullanır:

execl("/bin/sh", "sh", "-c", komut, (char *) NULL);

Komut tamamlanınca system() işlevi döner.

Komutun yürütülmesi sırasında system() çağrısının yapıldığı süreçte SIGCHLD engellenir, SIGINT ve SIGQUIT yok sayılır. (Bu sinyaller, komutu yürüten alt süreç içindeki öntanımlılarına göre işlenir.)

command NULL ise system(), sistemde bir kabuğun mevcut olup olmadığını gösteren bir durum döndürür.

DÖNÜŞ DEĞERİ

system() işlevinin dönüş değeri şunlardan biridir:

Son iki durumda dönüş değeri, waitpid(2) sayfasında açıklanan makrolar (WIFEXITED(), WEXITSTATUS() vb.) kullanılarak incelenebilen bir "bekleme durumu" kodudur.

system() herhangi bir başka alt sürecin bekleme durumunu etkilemez.

HATALAR

system() fork(2) ile aynı hatalardan herhangi biriyle başarısız olabilir.

ÖZNİTELİKLER

Bu bölümde kulllanılan terimlerin açıklamaları attributes(7) sayfasında bulunabilir.

UYUMLULUK

POSIX.1-2001, POSIX.1-2008, C89, C99.

EK BİLGİLER

system() basitlik ve kolaylık sağlar: fork(2), execl(3) ve waitpid(2) çağrılarının tüm ayrıntılarını ve ayrıca gerekli sinyal yönlendirimlerini ele alır; ek olarak, kabuk komut için olağan ikameleri ve G/Ç yönlendirmelerini gerçekleştirir. system() işlevinin ana maliyeti verimsizliktir: kabuğu çalıştıran süreci oluşturmak ve kabuğu çalıştırmak için ek sistem çağrıları gerekir.

_XOPEN_SOURCE özellik sınama makrosu tanımlanırsa (herhangi bir başlık dosyası dahil edilmeden önce), waitpid(2) içinde açıklanan makrolar (WEXITSTATUS(), vb.), <stdlib.h> dahil edildiğinde kullanılabilir hale gelir.

Bahsedildiği gibi; system(), SIGINT ve SIGQUIT sinyalini yoksayar. Bu, uygulamaların kendi çocuklarının çıkış durumlarını kontrol etmedikleri takdirde aşağıdaki örnekteki gibi durdurulamaz bir döngüden sürekli çağrılan uygulamalara sebep olabilir.

while (birsey) {
int donen = system("foo");

if (WIFSIGNALED(donen) &&
    (WTERMSIG(donen) == SIGINT || WTERMSIG(donen) == SIGQUIT))
        break;
}

POSIX.1'e göre, system() işlevinin yürütülmesi sırasında pthread_atfork(3) kullanılarak kaydedilen işleyicilerin çağrılıp çağrılmayacağı konusu belirlenmemiştir. glibc gerçekleniminde bu tür işleyiciler çağrılmamaktadır.

command NULL ise /bin/sh'nin kullanılabilirliğinin sınanması 2.1.3'ten önceki glibc sürümlerinde gerçekleştirilmezdi; bunun yerine her zaman kullanılabilir olduğu varsayılırdı ve system() bu durumda her zaman 1 döndürürdü. POSIX.1-2001 bir kabuk sağlamak için uyumlu bir uygulama gerektirmesine rağmen, çağıran uygulama daha önce chroot(2) çağrısı yapmışsa, kabuk kullanılabilir veya yürütülebilir olmayabileceğinden (POSIX.1-2001 tarafından bu durum belirtilmese de) Glibc 2.1.3'ten bu yana bu sınama yapılmaktadır.

Alt süreçte bir kabuğun yürütülemediği durumdan ayırt edilemeyecek şekilde, system() işlevinden dönen 127 değeri nedeniyle kabuk komutunun 127 durum koduyla sona ermiş gibi görünmesi mümkündür.

İLGİLİ BELGELER

sh(1), execv(2), fork(2), sigaction(2), sigprocmask(2), wait(2), exec(3), signal(7)

ÇEVİREN