> Linux Reviews > man >

stat

drukuj status pliku lub systemu plik�w

stat.1.man
stat.2.man

1. stat.1.man

Manpage of STAT

STAT

Section: polecenia u�ytkownika (1)
Updated: lipiec 2002
Index Return to Main Contents

NAZWA

stat - drukuj status pliku lub systemu plik�w

SK�ADNIA

stat [OPCJA] PLIK...

OPIS

Wy�wietla status pliku lub systemu plik�w

-f, --filesystem: wy�wietla informacje o stanie systemu plik�w, a nie o stanie pliku
-c --format=FORMAT: u�ywa podanego FORMATU zamiast formatu domy�lnego
-l, --dereference: pod��a za linkami
-t, --terse: wy�wietla informacje w zwi�z�ej postaci
--help: wy�wietla pomoc i ko�czy dzia�anie
--version: wy�wietla informacje o wersji i ko�czy dzia�anie

Poprawne sekwencje formatu dla plik�w (je�eli nie podano opcji --filesystem):

: %A - prawa dost�pu w formie czytelnej dla cz�owieka
%a - prawa dost�pu �semkowo
%b - liczba zaalokowanych blok�w
%D - numer urz�dzenia szesnastkowo
%d - numer urz�dzenia w systemie dziesi�tnym
%F - typ pliku
%f - tryb pliku szesnastkowo
%G - nazwa grupy, kt�ra jest w�a�cicielem pliku
%g - identyfikator grupy, kt�ra jest w�a�cicielem pliku
%h - liczba twardych dowi�za�
%i - numer w�z�a (inode)
%N - nazwa pliku w apostrofach ze wskazaniem link�w symbol.
%n - nazwa pliku
%o - rozmiar bloku wej�cia/wyj�cia
%s - ca�kowity rozmiar w bajtach
%T - poboczny (minor) typ urz�dzenia szesnastkowo
%t - g��wny (major) typ urz�dzenia szesnastkowo
%U - nazwa w�a�ciciela pliku
%u - identyfikator w�a�ciciela pliku
%X - czas ostatniego dost�pu podany jako liczba sekund od epoki
%x - czas ostatniego dost�pu
%Y - czas ostatniej modyfikacji jako liczba sekund od epoki
%y - czas ostatniej modyfikacji
%Z - czas ostatniej zmiany podany jako liczba sekund od epoki
%z - czas ostatniej zmiany

Poprawne sekwencje formatu dla system�w plik�w:

: %a - liczba wolnych blok�w dost�pnych dla nie-administrator�w
%b - ca�kowita liczba blok�w danych w systemie plik�w
%c - ca�kowita liczba w�z��w w systemie plik�w
%d - liczba wolnych w�z��w w systemie plik�w
%f - liczba wolnych blok�w w systemie plik�w
%i - identyfikator systemu plik�w szesnastkowo
%l - maksymalna d�ugo�� nazw plik�w
%n - nazwa pliku
%s - optymalny rozmiar bloku przy transferze
%T - typ w formie czytelnej dla cz�owieka
%t - typ szesnastkowo

AUTOR

Napisane przez Michaela Meskesa.

ZG�ASZANIE B��D�W

Prosimy zg�asza� b��dy do <bug-fileutils@gnu.org>.

PRAWA AUTORSKIE

Copyright © 2002 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

Pe�na dokumentacja programu stat jest utrzymywana w postaci podr�cznika texinfo. Je�eli programy info i stat zosta�y poprawnie zainstalowane, to za pomoc� polecenia

: info stat

mo�na uzyska� dost�p do pe�nej wersji podr�cznika.

This document was created by man2html using the manual pages.
Time: 00:25:15 GMT, November 20, 2008

2. stat.2.man

Manpage of STAT

STAT

Section: Podr�cznik programisty Linuksa (2)
Updated: 2004-06-23
Index Return to Main Contents

NAZWA

stat, fstat, lstat - pobiera status pliku

SK�ADNIA

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

int stat(const char *path, struct stat *buf);
int fstat(int filedes, struct stat *buf);
int lstat(const char *path, struct stat *buf);

OPIS

Funkcje te zwracaj� informacje o podanym pliku. Do uzyskania tej informacji nie s� wymagane prawa dost�pu do samego pliku, lecz --- w przypadku stat() i lstat() --- konieczne s� prawa wykonywania (przeszukiwania) do wszystkich katalog�w na prowadz�cej do pliku �cie�ce path.

stat() zwraca status pliku wskazywanego przez path, �aduj�c go do argumentu buf.

lstat() jest identyczny z stat(), lecz w przypadku gdy path jest linkiem symbolicznym, to zwraca status tego linka, a nie pliku, do kt�rego si� ten link odwo�uje.

fstat() jest identyczny z stat(), z tym wyj�tkiem, �e plik, kt�rego status ma zwr�ci�, jest okre�lony przez deskryptor pliku filedes.

Wszystkie te funkcje zwracaj� struktur� stat, zawieraj�c� nast�puj�ce pola:

struct stat {
    dev_t     st_dev;      /* ID urz�dzenia zawieraj�cego plik */
    ino_t     st_ino;      /* numer i-w�z�a (inode) */
    umode_t   st_mode;     /* ochrona */
    nlink_t   st_nlink;    /* liczba dowi�za� sta�ych (hardlinks) */
    uid_t     st_uid;      /* ID u�ytkownika w�a�ciciela */
    gid_t     st_gid;      /* ID grupy w�a�ciciela */
    dev_t     st_rdev;     /* ID urz�dzenia (je�li plik specjalny) */
    off_t     st_size;     /* ca�kowity rozmiar w bajtach */
    blksize_t st_blksize;  /* wielko�� bloku dla I/O systemu plik�w */
    blkcnt_t  st_blocks;   /* liczba zaalokowanych blok�w */
    time_t    st_atime;    /* czas ostatniego dost�pu */
    time_t    st_mtime;    /* czas ostatniej modyfikacji */
    time_t    st_ctime;    /* czas ostatniej zmiany */
};

Pole st_dev okre�la urz�dzenie, na kt�rym plik si� znajduje.

Pole st_rdev opisuje urz�dzenie reprezentowane przez ten plik (i-w�ze�).

Pole st_size podaje rozmiar pliku w bajtach (je�eli plik jest regularny lub jest dowi�zaniem symbolicznym). Rozmiarem dowi�zania symbolicznego jest d�ugo�� cie�ki, na kt�r� wskazuje, z wy��czeniem ko�cowego bajtu null.

Pole st_sblocks okre�la liczb� blok�w zajmowanych przez plik w jednostkach 512-bajtowych. (Liczba ta mo�e by� mniejsza ni� st_size/512, na przyk�ad wtedy, gdy plik ma dziury).

Pole st_blksize zawiera "preferowany" rozmiar bloku dla efektywnych operacji wej�cia/wyj�cia dla pliku (Zapis do pliku mniejszych kawa�k�w mo�e spowodowa� nieefektywne operacje odczyt-modyfikacja-powt�rny zapis).

Nie wszystkie systemy plik�w pod Linuksem obs�uguj� wszystkie pola czasu. Niekt�re systemy plik�w mo�na zamontowa� w ten spos�b, �e dost�p do pliku nie powoduje uaktualnienia pola st_atime. (Patrz `noatime' w mount(8)).

Pole st_atime jst zmieniane przez dost�p do pliku, np. przez execve(2), mknod(2), pipe(2), utime(2) i read(2) (w razie odczytania wi�cej ni� zera bajt�w). Inne procedury, jak mmap(2) mog�, ale nie musz�, zmieni� st_atime.

Zazwyczaj pole st_mtime jest zmieniane przez modyfikowanie pliku, np. przez mknod(2), truncate(2), utime(2) i write(2) (wi�cej ni� zero bajt�w). Co wi�cej st_mtime katalogu jest zmieniane przy tworzeniu plik�w w tym katalogu lub ich usuwaniu. Pole st_mtime nie jest zmieniane po zmianach w�a�ciciela, grupy, liczby twardych link�w (hardlinks) czy praw dowi�za�.

Pole st_ctime jest zmieniane przy zapisywaniu lub ustawianiu informacji i-w�z�a (np. w�a�ciciela, grupy, liczby dowi�za�, praw itp.).

Zdefiniowane s� nast�puj�ce makra POSIX sprawdzaj�ce typ pliku przy u�yciu pola st_mode:

S_ISREG(m): czy plik jest regularny?
S_ISDIR(m): katalog?
S_ISCHR(m): urz�dzenie znakowe?
S_ISBLK(m): urz�dzenie blokowe?
S_ISFIFO(m): kolejka FIFO (potok nazwany)?
S_ISLNK(m): dowi�zanie symboliczne? (Nie w POSIX.1-1996).
S_ISSOCK(m): gniazdo? (Nie w POSIX.1-1996).

Dla pola st_mode zdefiniowano nast�puj�ce flagi:

S_IFMT	0170000	maska bitowa dla p�l bitowych typu pliku
S_IFSOCK	0140000	gniazdo
S_IFLNK	0120000	dowi�zanie symboliczne (symbolic link)
S_IFREG	0100000	plik regularny
S_IFBLK	0060000	urz�dzenie blokowe
S_IFDIR	0040000	katalog
S_IFCHR	0020000	urz�dzenie znakowe
S_IFIFO	0010000	kolejka FIFO
S_ISUID	0004000	bit `set UID'
S_ISGID	0002000	bit `set-group-ID' (patrz ni�ej)
S_ISVTX	0001000	bit `sticky' (patrz ni�ej)
S_IRWXU	00700	maska praw dost�pu w�a�ciciela pliku
S_IRUSR	00400	w�a�ciciel ma prawa odczytu
S_IWUSR	00200	w�a�ciciel ma prawa zapisu
S_IXUSR	00100	w�a�ciciel ma prawa wykonania
S_IRWXG	00070	maska praw dost�pu dla grupy
S_IRGRP	00040	grupa ma prawa odczytu
S_IWGRP	00020	grupa ma prawa zapisu
S_IXGRP	00010	grupa ma prawa wykonania
S_IRWXO	00007	maska uprawnie� dla innych (poza grup�)
S_IROTH	00004	inni maj� prawa odczytu
S_IWOTH	00002	inni maj� prawa zapisu
S_IXOTH	00001	inni maj� prawa wykonania

Bit `set-group-ID' (S_ISGID) ma kilka specjalnych znacze�. Ustawiony na katalogu oznacza, �e dla tego katalogu powinna by� u�ywana semantyka BSD: pliki w nim utworzone dziedzicz� identyfikator grupy z katalogu, a nie z efektywnego identyfikatora grupy procesu tworz�cego plik, a tworzone katalogi b�d� mia�y tak�e ustawiony bit S_ISGID. Dla pliku, kt�ry nie ma ustawionego bitu wykonywania dla grupy (S_IXGRP), bit `set-group-ID' oznacza obowi�zkowe blokowanie pliku/rekordu. Bit `sticky' (S_ISVTX) ustawiony na katalogu oznacza, �e tylko w�a�ciciel pliku lub w�a�ciciel katalogu, lub proces uprzywilejowany mo�e usun�� plik w tym katalogu lub zmieni� nazw� tego pliku.

UWAGI LINUKSOWE

Od wersji j�dra struktura stat obs�uguje nanosekundow� dok�adno�� wszystkich trzech p�l czasowych. Glibc podaje nanosekundow� cz�� ka�dego z tych p�l, u�ywaj�c albo st_atim.tv_nsec, je�eli zdefiniowano makro _BSD_SOURCE lub _SVID_SOURCE, albo st_atimensec, je�eli nie zdefiniowano �adnego z tych makr. W systemach plik�w, kt�re nie obs�uguj� takiej dok�adno�ci czasowej, warto�ci nanosekund w tych polach wynosz� 0.

Dla wi�kszo�ci plik�w w katalogu /proc, stat() w polu st_size zwraca 0, a nie rzeczywisty rozmiar pliku.

WARTO�� ZWRACANA

Po sukcesie zwracane jest zero. Po b��dzie -1 i ustawiane jest errno.

B��DY

EACCES: Brak uprawnie� do przeszukiwania jednego z katalog�w w �cie�ce zaczynaj�cej path. (Patrz tak�e path_resolution(2)).
EBADF: filedes jest nieprawid�owy.
EFAULT: Niepoprawny adres.
ELOOP: Podczas rozwi�zywania �cie�ki napotkano zbyt wiele dowi�za� symbolicznych.
ENAMETOOLONG: Zbyt d�uga nazwa pliku.
ENOENT: Sk�adnik �cie�ki path nie istnieje lub �cie�ka jest pustym �a�cuchem znak�w.
ENOMEM: Brak pami�ci (tj. pami�ci j�dra).
ENOTDIR: Sk�adnik �cie�ki nie jest katalogiem.

ZGODNE Z

Funkcje stat() i fstat() s� zgodne z SVr4, SVID, POSIX, X/OPEN, 4.3BSD. Funkcja lstat() jest zgodna z 4.3BSD i SVr4. SVr4 dokumentuje nast�puj�ce dodatkowe b��dy fstat(): EINTR, ENOLINK i EOVERFLOW. SVr4 dokumentuje nast�puj�ce dodatkowe b��dy stat() i lstat(): EINTR, EMULTIHOP, ENOLINK i EOVERFLOW. U�ywanie p�l st_blocks i st_blksize mo�e by� ma�o przeno�ne. (Zosta�y wprowadzone w BSD, nie s� podawane przez POSIX. Interpretacja r�ni si� mi�dzy systemami, a nawet na jednym systemie, je�eli zaanga�owane s� montowania NFS).

Standard POSIX nie opisuje bit�w S_IFMT, S_IFSOCK, S_IFLNK, S_IFREG, S_IFBLK, S_IFDIR, S_IFCHR, S_IFIFO, S_ISVTX, ale zamiast tego wymaga u�ywania makr S_ISDIR(), itp. Makra S_ISLNK i S_ISSOCK nie wyst�puj� w POSIX.1-1996, ale oba b�d� w nast�pnej wersji standardu POSIX; pierwsze z tych makr jest wzi�te z SVID, a drugie z SUSv2.

Unix V7 (i kolejne systemy) mia� S_IREAD, S_IWRITE, S_IEXEC, podczas gdy POSIX nakazuje u�ywanie S_IRUSR, S_IWUSR, S_IXUSR.

INNE SYSTEMY

Warto�ci, kt�re by�y (lub nadal s�) w u�yciu w r�nych systemach:

szesnastkowo	nazwa	ls	�semkowo	opis
f000	S_IFMT		170000	maska bitowa dla p�l bitowych typu pliku
0000			000000	niedzia�aj�cy i-w�ze� w SCO, nieznany typ w BSD
				SVID-v2 i XPG2 maj� zar�wno 0, jak i 0100000 dla zwyk�ego pliku
1000	S_IFIFO	p\|	010000	kolejka FIFO (potok nazwany)
2000	S_IFCHR	c	020000	specjalny znakowy (V7)
3000	S_IFMPC		030000	specjalny znakowy zwielokrotniony (V7)
4000	S_IFDIR	d/	040000	katalog (V7)
5000	S_IFNAM		050000	nazwany plik specjalny XENIXa
				z dwoma podtypami, rozr�nianymi przez warto�ci 1,2 w st_rdev:
0001	S_INSEM	s	000001	podtyp IFNAM semafora XENIX
0002	S_INSHD	m	000002	podtyp IFNAM dzielonych danych XENIX
6000	S_IFBLK	b	060000	specjalny blokowy (V7)
7000	S_IFMPB		070000	specjalny blokowy zwielokrotniony (V7)
8000	S_IFREG	-	100000	regularny (V7)
9000	S_IFCMP		110000	skompresowany VxFS
9000	S_IFNWK	n	110000	sieciowy specjalny (HP-UX)
a000	S_IFLNK	l@	120000	dowi�zanie symboliczne (BSD)
b000	S_IFSHAD		130000	shadow i-w�ze� ACL w Solarisie (niedost. w przestrz. u�ytkow.)
c000	S_IFSOCK	s=	140000	gniazdo (BSD; tak�e "S_IFSOC" na VxFS)
d000	S_IFDOOR	D>	150000	drzwi Solarisa
e000	S_IFWHT	w%	160000	BSD whiteout (nieu�ywane dla i-w�z�a)

0200	S_ISVTX		001000	`bit sticky': zachowaj wyswappowany tekst nawet po u�yciu(V7)
				zarezerwowane (SVID-v2)
				Dla niekatalog�w: nie buforuj tego pliku (SunOS)
				Dla katalog�w: flaga ograniczonego usuwania (SVID-v4.2)
0400	S_ISGID		002000	set-group-ID podczas wykonywania (V7)
				dla katalog�w: u�ywaj semantyki BSD propagowania ID grupy
0400	S_ENFMT		002000	egzekwowanie blokowanie plik�w SysV (dzielone z S_ISGID)
0800	S_ISUID		004000	set-user-ID podczas wykonywania (V7)
0800	S_CDF		004000	katalog jest plikiem zale�nym od kontekstu (HP-UX)

Polecenie `sticky' pojawi�o si� w wersji32V systemu AT&T UNIX.

ZOBACZ TAK�E

chmod(2), chown(2), fstatat(2), readlink(2), utime(2), capabilities(7)

Index

NAZWA
SK�ADNIA
OPIS
UWAGI LINUKSOWE
WARTO�� ZWRACANA
B��DY
ZGODNE Z
INNE SYSTEMY
ZOBACZ TAK�E

This document was created by man2html using the manual pages.
Time: 00:25:15 GMT, November 20, 2008