NAZWA

       chown, fchown, lchown - zmiana właściciela pliku

SKŁADNIA

       #include <sys/types.h>
       #include <unistd.h>

       int chown(const char *path, uid_t owner, gid_t group);
       int fchown(int fd, uid_t owner, gid_t group);
       int lchown(const char *path, uid_t owner, gid_t group);

OPIS

        Uwaga! To tłumaczenie może być nieaktualne!

       Zmieniony  zostaje właściciel pliku określonego przez path lub przez deskryptor fd.  Tylko
       superużytkownik może zmieniać właściciela pliku.  Właściciel  pliku  może  zmieniać  tylko
       grupę  pliku na dowolną grupę, której jest członkiem.  Superużytkownik może zmieniać grupę
       bez ograniczeń.

       Jeśli owner lub group jest podane jako -1, to ten identyfikator nie jest wtedy zmieniany.

       Jeżeli właściciel lub grupa  pliku  uruchamialnego  są  zmieniane  przez  użytkownika  nie
       posiadającego   praw  superużytkownika,  to  atrybuty  S_ISUID  i  S_ISGID  pliku  zostaną
       wyzerowane. Standard POSIX nie precyzuje, czy atrybuty te powinny  być  również  zerowane,
       kiedy  to  użytkownik root wywołuje funkcję chown; zachowanie Linuksa w tym wypadku zależy
       od wersji jądra.  W przypadku pliku,  który  nie  ma  praw  uruchamiawania  dla  grupy  (z
       wyzerowanym bitem S_IXGRP), bit S_ISGID oznacza obowiązkowe blokowanie i nie jest zerowany
       przez chown.

WARTOŚĆ ZWRACANA

       Po pomyślnym  zakończeniu  zwracane  jest  zero.  W  wypadku  błędu  zwracane  jest  -1  i
       odpowiednio ustawiane errno.

BŁĘDY

       Dla  niektórych  systemów  plików  mogą  być  zwracane  inne  błędy  niż  opisane poniżej.
       Najogólniejsze błędy chown to:

       EPERM  Efektywny UID nie odpowiada właścicielowi pliku i nie jest  zerem  albo  owner  lub
              group zostały podane nieprawidłowo.

       EROFS  Podany plik znajduje się na systemie plików przeznaczonym tylko do odczytu.

       EFAULT path wskazuje poza dostępną dla użytkownika przestrzeń adresową.

       ENAMETOOLONG
              path jest zbyt długie.

       ENOENT Plik nie istnieje.

       ENOMEM Brak pamięci jądra.

       ENOTDIR
              Składnik ścieżki nie jest katalogiem.

       EACCES Brak praw do przeszukiwania dla składnika ścieżki.

       ELOOP  Podczas rozwiązywania path napotkano zbyt wiele dowiązań symbolicznych.

       Ogólne błędy dla fchown to:

       EBADF  Deskryptor pliku jest nieprawidłowy.

       ENOENT Zobacz wyżej.

       EPERM  Zobacz wyżej.

       EROFS  Zobacz wyżej.

       EIO    Niskopoziomowy błąd we/wy podczas modyfikacji i-węzła.

UWAGI

       W  wersjach  jądra  Linuksa  poniżej  2.1.81  (i  różnych  od  2.1.46) chown nie podąża za
       dowiązaniami symbolicznymi.   Od  wersji  2.1.81  Linuksa  chown  podąża  za  dowiązaniami
       symbolicznymi,  została  także  dodana  nowa funkcja systemowa lchown, która nie podąża za
       dowiązaniami symbolicznymi.  Od wersji 2.1.86 Linuksa, ta nowa funkcja (mająca  taką  samą
       semantykę jak stare chown) ma taki sam numer funkcji, a chown otrzymała nowy numer.

       Prototyp   dla   fchown   jest   dostępny   jedynie,  gdy  zdefiniowane  jest  _BSD_SOURCE
       (bezpośrednio, albo pośrednio - nie definiując _POSIX_SOURCE  czy  kompilując  z  włączoną
       flagą -ansi).

ZGODNE Z

       Funkcja  chown  jest  zgodna  z  SVr4, SVID, POSIX, X/OPEN. Wersja 4.4BSD może być używana
       tylko przez superużytkownika (to znaczy normalni użytkownicy nie mogą  "podarować"  nikomu
       plików).   SVr4 dokumentuje błędy EINVAL, EINTR, ENOLINK i EMULTIHOP, lecz nie dokumentuje
       ENOMEM. POSIX.1 nie dokumentuje błędów ENOMEM i ELOOP.

       Funkcja fchown jest zgodna z 4.4BSD oraz SVr4.  SVr4 dokumentuje dodatkowe  błędy  EINVAL,
       EIO, EINTR i ENOLINK.

OGRANICZENIA

       Semantyka  chown()  jest  pogwałcona  na systemach plików NFS, z włączonym mapowaniem UID.
       Dodatkowo, semantyka wszystkich wywołań systemowych, które uzyskują dostęp  do  zawartości
       plików  jest  dla  NFS pogwałcona, bo chown() może spowodować natychmiastowe unieważnienie
       dostępu  do  już  otwartych  plików.   Buforowanie  po  stronie  klienta  może  spowodować
       opóźnienie  możliwości  uzyskania  dostępu  do  pliku  przez  użytkowników  innych  stacji
       klienckich w stosunku do chwili dokonania zmiany właściciela umożliwiającej ten dostęp.

ZOBACZ TAKŻE

       chmod(2), flock(2)

INFORMACJE O TŁUMACZENIU

       Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia  Manuali  i  może
       nie  być  aktualne.  W  razie  zauważenia  różnic  między  powyższym opisem a rzeczywistym
       zachowaniem opisywanego programu lub  funkcji,  prosimy  o  zapoznanie  się  z  oryginalną
       (angielską) wersją strony podręcznika za pomocą polecenia:

              man --locale=C 2 chown

       Prosimy  o  pomoc  w  aktualizacji stron man - więcej informacji można znaleźć pod adresem
       http://sourceforge.net/projects/manpages-pl/.