Provided by:
manpages-cs_0.18.20090209-3_all 
JM'ENO
access - kontroluje pistupova prava k souboru
SYNTAXE
#include <unistd.h>
int access(const char *pathname, int mode);
POPIS
access kontroluje, zda proces me ist i zapisovat do souboru (nebo
jineho objektu souboroveho systemu) se jmenem pathname . Lze jej take
pouit ke zjitni existence pathname . Pokud je pathname symbolicky
odkaz, pak jsou testovana pistupova prava souboru, na ktery odkaz
smuje.
mode je maska obsahujici jednu i vice tchto monosti: R_OK, W_OK, X_OK a
F_OK.
R_OK, W_OK a X_OK provede testovani, zda soubor existuje a ma pro bici
proces nastavena prava ke teni (Read), psani (Write) a vykonani
(eXecute). F_OK kontroluje pouze existenci souboru.
Vysledek testu zavisi na pistupovych pravech adresa, je nalei cest k
souboru pathname, a na pistupovych pravech adresa a soubor, na ktere
smuji symbolicke odkazy na cest.
Kontrola je provedena se skuten'ym uid a gid procesu. Nebere se zetel na
efektivni id, ktere se projevi pi souborove operaci. Tak mohou setuid
programy snadno zjistit skutena prava uivatele.
Kontroluji se pouze piznakove bity; ne typ souboru i jeho obsah. Pokud
je adresa "zapisu schopny", lze v nm pravdpodobn tvoit soubory - nememe
do nj zapisovat, jako do bneho souboru. Zrovna tak DOSovy soubor me byt
"spustitelny", ale execve(2) bude stale protestovat.
N'AVRATOV'A HODNOTA
Pi uspchu (vechna kontrolovana prava jsou dostupna) vraci nulu. Pi
neuspchu (alespo jeden druh pistupu reprezentovany pislunym bitem z
mode je odepen, nebo nastane jina chyba), vraci -1, a promnna errno je
nastavena.
CHYBY
EACCES Poadovany pistup by byl odepen.
EFAULT pathname odkazuje nkam mimo pistupny adresovatelny diskovy
prostor.
EINVAL mode je zadan chybn.
ENAMETOOLONG
pathname je pili dlouhy.
ENOENT Adresae v pathname by mohly byt pistupne, ale neexistuji, nebo
jsou to volne symbolicke odkazy.
ENOTDIR
asti pathname pouite jako adresae ve skutenosti nejsou adresae
ENOMEM Malo pamti jadra.
ELOOP pathname obsahuje cyklicky symbolicky odkaz, nap. symbolicky
odkaz odkazuje sam na sebe.
OMEZEN'I
access vraci chybu i kdyby jeden jediny druh pistupu byl odepen a
vechny ostatni umonny.
access me zlobit na NFS souborovych systemech, ktere maji zapnute
mapovani UID, protoe mapovani UID je provadno na serveru a je skryto
ped klienty.
SPLUJE STANDARDY
SVID, AT&T, POSIX, X/OPEN, BSD 4.3
DAL'I INFORMACE
stat(2), open(2), chmod(2), chown(2), setuid(2), setgid(2).
VAROV'AN'I
Peklad je pravdpodobn zastaraly. Pokud chcete pomoci s jeho
aktualizaci, zamite na http://man-pages-cs-wiki.homelinux.net/
Linux 1.2.13 4. zai 1998 ACCESS(2)