İSİM

       system - bir kabuk komutunu çalıştırır

KULLANIM

       #include <stdlib.h>

       int system (const char *dizge);

AÇIKLAMA

       system()   dizge  ile belirtilen bir komutu, /bin/sh -c dizge çağrısıyla çalıştırır ve  komutun çalışması
       bittikten sonra geri döner. Komutun çalışması esnasında, SIGCHLD engellenir, SIGINT ve  SIGOUT  göz  ardı
       edilir.

DÖNÜŞ DEĞERİ

       Herhangi  bir  hatada  -1 döner (fork başarısız olmuş gibi), aksi takdirde komutun dönüş durumu döner. Bu
       sonuncu  dönüş  durumu  wait(2)  de  belirtilen  biçimde  olur.   Bundan  dolayı,  komutun   çıkış   kodu
       WEXITSTATUS(durum)  olacaktır.   /bin/sh'ın  çalıştırılamadığı  durumlarda, çıkış durumu, exit(127) yapan
       komutun durumu olacaktır.

       Şayet dizge değeri NULL ise ve kabuk uygunsa, system() sıfırsan farklı bir değer döndürür; uygun  değilse
       sıfır döndürür.

       system(), çocuk süreçlerden hiçbirinin bekleme durumunu etkilemez.

UYUMLULUK

       ANSI C, POSIX.2, BSD 4.3

NOTLAR

       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(birşey) {
         int donen = system("foo");

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

       Sistem  bütünlüğünü  bozmak  için,  bazı  çevre  değişkenleri  tuhaf  değerlerle   kullanılabileceğinden,
       system()'i  suid  veya  sgid  yetkileri  olan bir yazılımda kullanmayın. Onun yerine exec(3) ailesine ait
       işlevleri kullanın, ama execlp(3) veya execvp(3) işlevleri hariç. /bin/sh'ın  bash'ın  2.  sürümü  olduğu
       sistemlerde,  bash  başlatma  sırasında  yetkileri  tutacağından  system(),  suid  veya sgid hakları olan
       yazılımlardan düzgün çalışmayacaktır. (Debian sh olarak çağrıldığında  bunu  yapmayan  değiştirilmiş  bir
       bash kullanır.)

       /bin/sh'ın  kullanılabilirliği  aslında  kontrol  edilmez;  Daima kullanılabilir olduğu varsayılır. ISO C
       kontrolün yapılmasını isterse de POSIX.2  kabuktan  geri  dönen  değerin  daima  sıfırdan  farklı  olması
       gerektiğini  kabul  eder  (çünkü  kabuk  olmayan bir sistem uyumlu değildir ve uyum için kabuğun eklenmiş
       olması gerekmektedir).

       Kabuk komutu için 127 döndürmek mümkündür, bu nedenle kod, execve() çağrısının   hata  verdiğinin,  kesin
       bir kanıtı sayılamaz.

İLGİLİ BELGELER

       sh(1), signal(2), wait(2), exec(3).

ÇEVİREN

       Yalçın Kolukısa <yalcink01 (at) yahoo.com>, Kasım 2003

                                                  23 Eylül 2001                                        system(3)