> Linux Reviews > man >

chmod

zmienia prawa dost�pu do pliku

chmod.1.man
chmod.2.man

1. chmod.1.man

Manpage of CHMOD

CHMOD

Section: Narz�dzia plikowe GNU 4.0l (1)
Updated: FSF
Index Return to Main Contents

NAZWA

chmod - zmienia prawa dost�pu do pliku

SK�ADNIA

chmod [opcja]... tryb[,tryb]... plik...
chmod [opcja]... tryb-�semkowo plik...
chmod [opcja]... --reference=rplik plik...

OPIS

Dokumentacja niniejsza nie jest ju� utrzymywana i mo�e by� niedok�adna lub niekompletna. Autorytatywnym �r�d�em jest obecnie dokumentacja Texinfo. Dost�p do niej uzyskasz wpisuj�c w wierszu polece�:

: pinfo chmod

lub

: info chmod.

Ta strona podr�cznika man opisuje chmod w wersji GNU.

chmod zmienia prawa dost�pu do ka�dego podanego pliku wed�ug parametru tryb, kt�ry jest albo symboliczn� przedstawieniem zmian, kt�rych dokona�, albo �semkow� liczb� reprezentuj�c� wzorzec bitowy nowych praw.

Format trybu symbolicznego to `[ugoa...][[+-=][rwxXstugo...]...][,...]'. Mo�na poda� wiele operacji symbolicznych, oddzielonych przecinkami.

Kombinacja liter `ugoa' kontroluje, czyje prawa maj� zosta� zmienione: w�a�ciciela (u), innych u�ytkownik�w z tej samej grupy (g), innych u�ytkownik�w (o), lub wszystkich (a). Je�li �adnego z tych parametr�w nie podano, rezultatem jest u�ycie domy�lne `a', lecz bity, kt�re s� ustawione w umask nie s� zmieniane.

Operator `+' powoduje dodanie wybranych praw do istniej�cych; `-' powoduje ich odj�cie; `=' powoduje ustawienie dok�adnie takich praw, jakie wybrano.

Litery `rwxXstugo' wybieraj� nowe prawa dla u�ytkownik�w: odczytu (read) (r), zapisu (write) (w), wykonania (eXecute) (lub dost�pu do katalogu) (x), wykonania tylko je�li plik jest katalogiem, lub ju� ma prawa wykonania dla danego u�ytkownika (X), ustawienia ID grupy podczas wywo�ania (s), zachowania tekstu programu na urz�dzeniu wymiany (t), prawa kt�re posiada w�a�ciciel pliku (u), prawa innego u�ytkownika z grupy posiadaj�cej plik (g), prawa innych u�ytkownik�w (o).

Tryb numeryczny jest podaniem jednej do czterech �semkowych liczb (0-7), wyprowadzonych przez dodawanie warto�ci bitowych 4,2,1. Ka�da omini�ta cyfra jest traktowana jak zero. Pierwsza cyfra wybiera SUID (4) i SGID (2) oraz atrybut zachowania obrazu tekstowego (1). Nast�pna cyfra wybiera prawa dla w�a�ciciela: odczytu (4), zapisu (2), wykonania (1); trzecia cyfra prawa dla grupy posiadaj�cej plik, a czwarta dla innych u�ytkownik�w, spoza grupy (analogicznie do cyfry dla w�a�ciciela).

chmod nigdy nie zmienia praw dowi�za� symbolicznych, gdy� funkcja systemowa chmod nie potrafi tego dokona�. Nie jest to problemem, poniewa� prawa dowi�za� symbolicznych nigdy nie s� u�ywane. Jednak�e, dla ka�dego dowi�zania symbolicznego, wymienionego w wierszu polece�, chmod zmienia prawa wskazywanego przez nie pliku. W przeciwie�stwie do powy�szego, chmod ignoruje dowi�zania symboliczne napotkane podczas rekurencyjnego przechodzenia przez katalogi.

OPCJE

-c, --changes: Jak --verbose, ale wy�wietla tylko pliki, kt�rych prawa rzeczywi�cie si� zmieni�y.
-f, --silent, --quiet: Nie wy�wietla komunikat�w o b��dach dla plik�w, kt�rych praw nie da�o si� zmieni�.
-v, --verbose: Wy�wietla komunikaty diagnostyczne dla ka�dego przetwarzanego pliku.
-R, --recursive: Rekurencyjnie zmienia prawa katalog�w i ich zawarto�ci.
--reference=rplik: Pos�uguje si� prawami dost�pu wskazanego rpliku zamiast wprost podanego trybu.
--help: Wy�wietla informacj� o stosowaniu programu i dost�pnych opcjach, ko�czy dzia�anie.
--version: Wy�wietla numer wersji programu i ko�czy dzia�anie.

Ka�dy tryb sk�ada si� z co najmniej jednej z liter ugoa, jednego z symboli +-= oraz z co najmniej jednej z liter rwxXstugo.

Prawa dost�pu do plik�w opisano bli�ej w podr�czniku fileutils(1).

AUTOR

Napisane przez Davida MacKenzie.

ZG�ASZANIE B��D�W

B��dy prosz� zg�asza�, w j�z.ang., do <bug-fileutils@gnu.org>.

COPYRIGHT

Copyright © 1999 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

ZOBACZ TAK�E

chown(1), chgrp(1), ls(1), find(1), fileutils(1).

OD T�UMACZA

Zaktualizowano i poszerzono wg dokumentacji Texinfo dla narz�dzi plikowych GNU wersji 4.01.

Index

NAZWA

SK�ADNIA

OPIS

OPCJE

AUTOR

ZG�ASZANIE B��D�W

COPYRIGHT

ZOBACZ TAK�E

OD T�UMACZA

This document was created by man2html using the manual pages.
Time: 23:26:00 GMT, July 09, 2008

2. chmod.2.man

Manpage of CHMOD

CHMOD

Section: Podr�cznik programisty Linuksa (2)
Updated: 1997-12-10
Index Return to Main Contents

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

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)

This document was created by man2html using the manual pages.
Time: 23:26:00 GMT, July 09, 2008