CHMOD(2)

NAZWA
chmod, fchmod - zmiana praw do pliku

SKŁADNIA
#include <sys/types.h>
#include <sys/stat.h>

int chmod(const char *path, mode_t mode);
int fchmod(int fildes, mode_t mode);

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

Zmienione zostają prawa dostępu do pliku określonego przez path lub wskazywanego przez filedes. Prawa są podawane jako or następujących wartości:

    S_ISUID
        04000 ustawia ID użytkowinka przy uruchomieniu

    S_ISGID
        02000 ustawia ID grupy przy uruchomieniu

    S_ISVTX
        01000 bit "sticky"

    S_IRUSR (S_IREAD)
        00400 odczyt przez właściciela

    S_IWUSR (S_IWRITE)
        00200 zapis przez właściciela

    S_IXUSR (S_IEXEC)
        00100 uruchomianie/przeszukiwanie przez właściciela

    S_IRGRP
        00040 odczyt przez grupę

    S_IWGRP
        00020 zapis przez grupę

    S_IXGRP
        00010 uruchomianie/przeszukiwanie przez grupę

    S_IROTH
        00004 odczyt przez pozostałych

    S_IWOTH
        00002 zapis przez pozostałych

    S_IXOTH
        00001 uruchomianie/przeszukiwanie przez pozostałych

Efektywny UID procesu musi być zerem, lub odpowiadać właścicielowi pliku. Jeśli efektywny UID procesu jest różny od zera, a grupa pliku różni się od efektywnego ID grupy procesu i nie jest też żadną z kego grup dodatkowych, to bit S_ISGID zostanie wyzerowany, ale nie spowoduje to wystąpienia błędu. Zależnie od systemu plików, bity SUID i SGID mogą zostać wyłączone podczas zapisywania pliku. Na niektórych systemach plików, tylko superużytkownik może ustawić bit "sticky", który może mieć specjalne znaczenie. Znaczenie bitów "sticky", SUID i SGID dla katalogów opisano w stat(2). Na systemach plików NFS, ograniczanie praw będzie miało natychmiastowy wpływ na aktualnie otwarte pliki, gdyż kontrola dostępu dokonywana jest na serwerze, a otwarte pliki obsługiwane sa przez klienta. Rozszerzenie uprawnień może zostać udostępnione z opóźnieniem innym klientom, jeśli mają włączone buforowanie atrybutów.

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 chmod to:

EPERM
    Efektywny UID nie odpoiwada właścicielowi pliku i nie jest zerem.

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.

EIO Wystąpił błąd wejścia-wyjścia.

Ogólne błędy dla fchmod to:

EBADF
    Deskryptor pliku fildes jest nieprawidłowy.

EROFS
    Zobacz wyżej.

EPERM
    Zobacz wyżej.

EIO Zobacz wyżej.

ZGODNE Z
Funkcja chmod jest zgodna z SVr4, SVID, POSIX, X/OPEN, 4.4BSD. SVr4 dokumentuje błędy EINTR, ENOLINK i EMULTIHOP, lecz nie dokumentuje ENOMEM. POSIX.1 nie dokumentuje błędów EFAULT, ENOMEM, ELOOP i EIO, ani makr S_IREAD, S_IWRITE i S_IEXEC.

Funkcja fchmod jest zgodna z 4.4BSD i SVr4. SVr4 dokumentuje dodatkowe błędy EINTR i ENOLINK. POSIX wymaga funkcji fchmod, gdy zdefiniowane jest co najmniej jedno z _POSIX_MAPPED_FILES i _POSIX_SHARED_MEMORY_OBJECTS oraz dokumentuje dodatkowe błędy ENOSYS i EINVAL, ale nie dokumentuje EIO.

POSIX i X/OPEN nie dokumentują bitu "sticky".

ZOBACZ TAKŻE
open(2),
    chown(2), execve(2), stat(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 chmod

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