[Cerber-commits]cerb-ng/docs OPERATIONS-PL.txt,1.5,1.6

[<da...@us...>]

Update of /cvsroot/cerber/cerb-ng/docs
In directory sc8-pr-cvs1:/tmp/cvs-serv23215/docs

Modified Files:
	OPERATIONS-PL.txt 
Log Message:
Cleanups.

Index: OPERATIONS-PL.txt
===================================================================
RCS file: /cvsroot/cerber/cerb-ng/docs/OPERATIONS-PL.txt,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** OPERATIONS-PL.txt	27 Jan 2003 17:41:55 -0000	1.5
--- OPERATIONS-PL.txt	28 Jan 2003 17:32:29 -0000	1.6
***************
*** 155,159 ****
  	CONFERR:
  		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:	Wszystkie, jakie mo¿e zwróciæ namei(9).
  
  STR:getpname([UDEF:pid])
--- 155,160 ----
  	CONFERR:
  		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		[ Wszystkie jakie mo¿e zwróciæ namei(9). ]
  
  STR:getpname([UDEF:pid])
***************
*** 251,255 ****
  	RETURN:	¦cie¿ka do poprzedniego pliku wykonywalnego lub NULL je¶li
  		wystapi³ b³±d.
! 	TECH:	Dok³adnie zamieniany jest vnode w p->p_textvp.
  	DOC:	vnode(9)
  	CONFERR:
--- 252,256 ----
  	RETURN:	¦cie¿ka do poprzedniego pliku wykonywalnego lub NULL je¶li
  		wystapi³ b³±d.
! 	TECH:	W rzeczywisto¶ci zamieniany jest vnode w p->p_textvp.
  	DOC:	vnode(9)
  	CONFERR:
***************
*** 440,572 ****
  		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
  
! ismember([UDEF:pid,]<UDEF:gid>)
! 	opis:	sprawdza czy UID aktualnego procesu (je¶li podano jeden
! 		argument) lub procesu o numerze PID ,,pid'' (je¶li podane
! 		dwa argumenty) jest cz³onkiem grupy ,,gid''
! 	zwracana warto¶æ:	1 - jest cz³onkiem,
! 				0 - nie jest,
! 				-1 - nie istnieje proces o podanym numerze PID
! 	dokumentacja:	getgroups(2), groups(1), group(5), getgrouplist(3)
  
! addgroup([UDEF:pid,]<UDEF:gid>)
! 	opis:	UID aktualnego procesu (je¶li podano jeden argument) lub porcesu
! 		o numerze PID ,,pid'' staje siê cz³onkiem grupy ,,gid'',
! 		cz³onkostwo jest nadawane jedynie w obrêbie procesu
! 	zwracana warto¶æ:	1 - operacja siê powid³a,
! 				0 - UID jest ju¿ cz³onkiem podanej grupy,
! 				-1 - nie istnieje proces o odanym numerze PID
! 	dokumentacja:	setgroups(2)
  
! delgroup([UDEF:pid,]<UDEF:gid>)
! 	opis:	UID aktualnego procesu (je¶li podano jeden argument) lub procesu
! 		o numerze PID ,,pid'' (je¶li podano dwa argumenty) przestaje byæ
! 		cz³onkiem grupy ,,gid'', cz³onkostwo odbierane jest jedynie
! 		w obrêbie procesu
! 	zwracana warto¶æ:	1 - operacja siê powiod³a,
! 				0 - UID nie by³ cz³onkiem podanej grupy,
! 				-1 - nie istnieje proces o podanym numerze PID
! 	dokumentacja:	setgroups(2)
  
! isjailed([UDEF:pid|ST_PRISON:prison])
! 	opis:	operacja sprawdza czy proces o numerze PID ,,pid'' (lub
! 		aktualny proces, je¶li nie podano ,,pid'') jest zamkniêty
! 		w jail'u, mo¿na podaæ równie¿ ,,prison'', który to argument
! 		jest typu ST_PRISON
! 	zwracana warto¶æ:	1 - proces jest zamkniêty w jail'u,
! 				0 - proces nie jest uwiêziony,
! 				-1 - nie istnieje proces o podanym numerze PID
  
! getjailhost([UDEF:pid|ST_PRISON:prison])
! 	opis:	Podaje nazwê hosta jail'a, w którym zamkniêty jest aktualny
! 		proces lub proces o numerze PID ,,pid'', mo¿na podaæ równie¿
! 		,,prison'', który to argument jest byæ typu ST_PRISON
! 	zwracana warto¶æ:	ci±g pusty je¶li proces nie jest zamkniêty
! 				w jail'u lub nazwê hosta dla jail'a
  
! getjaildir([UDEF:pid])
! 	opis:	Podaje ¶cie¿kê do katalogu do którego zosta³ chroot'owany
! 		jail, w którym zamkniêty jest aktualny proces lub proces
! 		o numerze PID ,,pid''
! 	zwracana warto¶æ:	ci±g pusty je¶li proces nie jest zamkniêty
! 				w jail'u lub nazwê katalogu
  
! getjailip([UDEF:pid|ST_PRISON:prison])
! 	opis:	Podaje numer IP, który zosta³ przypisany jail'owi, w którym
! 		zosta³ zamkniêty aktualny proces lub proces o numerze
! 		PID ,,pid'', mo¿na podaæ równie¿ ,,prison'', który to argument
! 		jest byæ typu ST_PRISON
! 	zwracana warto¶æ:	ci±g pusty je¶li proces nie jest zamkniêty
! 				w jail'u lub nnumer IP jail'a
  
! getinode([STR:path|UDEF:pid])
! 	opis:	podaje numer i-wêz³a pliku wykonywalnego, z którego zosta³
! 		uruchomiony aktualny process (je¶li nie podano argumentu) lub
! 		proces o podanym numerze PID (je¶li podano jako argument
! 		,,pid'') lub po prostu numer i-wêz³a podanego pliku/katalogu
! 		(je¶li argumentem jest ,,path'')
! 	zwracana warto¶æ:	numer i-wêz³a lub -1 je¶li plik/katalog lub
! 				proces nie istniej±
! 	dokumentacja:	stat(2)
  
! getdev([STR:path|UDEF:pid])
! 	opis:	analogicznie jak getinode(), tylko podaje numer urz±dzenia, na
! 		którym znajduje siê i-wêze³
! 	zwracana warto¶æ:	numer urz±dzenia lub -1 je¶li plik/katalog lub
! 				proces nie istniej±
! 	dokumentacja:	stat(2)
  
! getouid([STR:path|UDEF:pid])
! 	opis:	podaje numer UID w³a¶ciciela pliku wykonywalnego, z którego
! 		zosta³ uruchomiony aktualny process (je¶li nie podano
! 		argumentu) lub proces o podanym numerze PID (je¶li podano jako
! 		argument ,,pid'') lub po prostu numer UID w³a¶ciciela podanego
! 		pliku/katalogu (je¶li argumentem jest ,,path'')
! 	zwracana warto¶æ:	numer UID lub -1 je¶li podany plik/katalogu lub
! 				proces nie istniej±
! 	dokumentacja:	stat(2), chown(2), chown(8)
  
! getogid([STR:path|UDEF:pid])
! 	opis:	analogicznie jak getouid(), tylko zwraca numer UID w³a¶ciciela
! 		pliku/katalogu
  
! getmode([STR:path|UDEF:pid])
! 	opis:	podaje prawa dostêpu do pliku wykonywalnego, z którego zosta³
! 		uruchomiony aktualny process (je¶li nie podano argumentu) lub
! 		proces o podanym numerze PID (je¶li podano jako argument
! 		,,pid'') lub po prostu prawa dostêpu do podanego pliku/katalogu
! 		(je¶li argumentem jest ,,path'')
! 	zwracana warto¶æ:	prawa dostêpu lub -1 je¶li podany plik/katalog
! 				lub proces nie istniej±
! 	dokumentacja:	stat(2), chmod(1), chmod(2)
  
! getflags([STR:path|UDEF:pid])
! 	opis:	podaje flagi pliku wykonywalnego, z którego zosta³ uruchomiony
! 		aktualny process (je¶li nie podano argumentu) lub proces o
! 		podanym numerze PID (je¶li podano jako argument ,,pid'') lub po
! 		prostu flagi podanego pliku/katalogu (je¶li argumentem jest
! 		,,path'')
! 	zwracana warto¶æ:	flagi lub -1 je¶li podany plik/katalog lub
! 				proces nie istniej±
! 	dokumentacja:	stat(2), chflags(1), chflags(2)
  
! getnlinks([STR:path|UDEF:pid])
! 	opis:	podaje ilo¶æ twardych linków do pliku wykonywalnego, z którego
! 		zosta³ uruchomiony aktualny process (je¶li nie podano argumentu)
! 		lub proces o podanym numerze PID (je¶li podano jako argument
! 		,,pid'') lub po prostu ilo¶æ twardych linków do podanego
! 		pliku/katalogu (je¶li argumentem jest ,,path'')
! 	zwracana warto¶æ:	ilo¶æ twardych linków lub -1 je¶li podany
! 				plik/katalog lub proces nie istniej±
! 	dokumentacja:	stat(2), ln(1), link(2)
  
! getsize([STR:path|UDEF:pid])
! 	opis:	podaje rozmiar w bajtach pliku wykonywalnego, z którego zosta³
! 		uruchomiony aktualny process (je¶li nie podano argumentu) lub
! 		proces o podanym numerze PID (je¶li podano jako argument
! 		,,pid'') lub po prostu rozmiar podanego pliku/katalogu (je¶li
! 		argumentem jest ,,path'')
! 	zwracana warto¶æ:	rozmiar w bajtach lub -1 je¶li podany
! 				plik/katalog lub proces nie istniej±
! 	dokumentacja:	stat(2)
  
  fdcache(<DEF:fd>,<STR:name>)
--- 441,634 ----
  		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
  
! UDEF:ismember([UDEF:pid,]<UDEF:gid>)
! 	DESC:	Sprawdza czy aktualnego proces (je¶li podano jeden argument) lub
! 		proces o numerze PID ,,pid'' jest cz³onkiem grupy ,,gid''.
! 	RETURN:	 1 - jest cz³onkiem,
! 		 0 - nie jest,
! 		-1 - wyst±pi³ b³±d.
! 	DOC:	getgroups(2), groups(1), group(5), getgrouplist(3)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub ich typy.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
  
! UDEFPTR:addgroup([UDEF:pid,]<UDEF:gid>)
! 	DESC:	Dodaje cz³onkostwo aktualnego procesu (je¶li podano jeden
! 		argument) lub procesu o numerze PID ,,pid'' do grupy o numerze
! 		GID ,,gid''.
! 	RETURN:	Tablica z poprzednimi grupami lub NULL je¶li wyst±pi³ b³±d.
! 	DOC:	setgroups(2)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub ich typy.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
  
! UDEFPTR:delgroup([UDEF:pid,]<UDEF:gid>)
! 	DESC:	Usuwa cz³onkostwo aktualnego procesu (je¶li podano jeden
! 		argument) lub procesu o numerze PID ,,pid'' z grupy o numerze
! 		GID ,,gid''.
! 	RETURN:	Tablica z poprzednimi grupami lub NULL je¶li wyst±pi³ b³±d.
! 	DOC:	setgroups(2)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub ich typy.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
  
! UDEF:isjailed([UDEF:pid])
! 	DESC:	Sprawdza czy aktualny proces (je¶li nie podano argumentu) lub
! 		proces o numerze PID ,,pid'' jest zamkniêty w jailu.
! 	RETURN:	 1 - jest zamkniêty,
! 		 0 - nie jest zamkniety,
! 		-1 - wyst±pi³ b³±d.
! 	DOC:	jail(8), jail(2)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
  
! STR:getjailhost([UDEF:pid|ST_PRISON:prison])
! 	DESC:	Podaje nazwê hosta dla podanego jaila (je¶li argument jest typu
! 		ST_PRISON), dla jaila, w którym zamkniêty jest aktualny proces
! 		(je¶li nie podano argumentu) lub dla jaila, w którym zamkniêty
! 		jest proces o numerze PID ,,pid''.
! 	RETURN:	Nazwa hosta lub NULL je¶li wyst±pi³ b³±d.
! 	DOC:	jail(8), jail(2)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
  
! STR:getjaildir([UDEF:pid])
! 	DESC:	Podaje ¶cie¿kê do katalogu, w którym zamkniêty jest aktualny
! 		proces (je¶li nie podano argumentu) lub proces o numerze PID
! 		,,pid''.
! 	RETURN:	Bezwzglêdn± ¶cie¿kê lub NULL je¶li wystapi³ b³±d.
! 	DOC:	jail(8), jail(2)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
! 		EINVAL	-
! 		EBADF	-
! 		ENOTDIR	-
! 		ENOENT	-
! 		ENAMETOOLONG	-
  
! STR:getjailip([UDEF:pid|ST_PRISON:prison])
! 	DESC:	Podaje numer IP dla podanego jaila (je¶li argument jest typu
! 		ST_PRISON), dla jaila, w którym zamkniêty jest aktualny proces
! 		(je¶li nie podano argumentu) lub dla jaila, w którym zamkniêty
! 		jest proces o numerze PID ,,pid''.
! 	RETURN:	Nnumer IP lub NULL je¶li wyst±pi³ b³±d.
! 	DOC:	jail(8), jail(2)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
  
! UDEF:getinode([STR:path|UDEF:pid])
! 	DESC:	Podaje numer inode podanego pliku (je¶li argument jest typu
! 		STR), pliku, z którego zosta³ wykonany aktualny proces (je¶li
! 		nie podano argumentu) lub proces o numerze PID ,,pid''.
! 	RETURN:	Numer inode pliku lub -1 je¶li wyst±pi³ b³±d.
! 	DOC:	stat(2)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
! 		EFAULT	- Argument ,,path'' jest równy NULL.
! 		[ Wszystkie jakie mo¿e zwróciæ namei(9) lub VOP_GETATTR(9). ]
  
! UDEF:getdev([STR:path|UDEF:pid])
! 	DESC:	Podaje numer inode urz±dzenia na którym znajduje siê podany plik
! 		(je¶li argument jest typu STR), plik, z którego zosta³ wykonany
! 		aktualny proces (je¶li nie podano argumentu) lub proces o
! 		numerze PID ,,pid''.
! 	RETURN:	Numer inode urz±dzenia lub -1 je¶li wyst±pi³ b³±d.
! 	DOC:	stat(2)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
! 		EFAULT	- Argument ,,path'' jest równy NULL.
! 		[ Wszystkie jakie mo¿e zwróciæ namei(9) lub VOP_GETATTR(9). ]
  
! UDEF:getouid([STR:path|UDEF:pid])
! 	DESC:	Podaje numer UID w³a¶ciciela podanego pliku (je¶li argument jest
! 		typu STR), pliku, z którego zosta³ wykonany aktualny proces
! 		(je¶li nie podano argumentu) lub proces o numerze PID ,,pid''.
! 	RETURN:	Numer UID lub -1 je¶li wyst±pi³ b³±d.
! 	DOC:	stat(2), chown(2), chown(8)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
! 		EFAULT	- Argument ,,path'' jest równy NULL.
! 		[ Wszystkie jakie mo¿e zwróciæ namei(9) lub VOP_GETATTR(9). ]
  
! UDEF:getogid([STR:path|UDEF:pid])
! 	DESC:	Podaje numer GID w³a¶ciciela podanego pliku (je¶li argument jest
! 		typu STR), pliku, z którego zosta³ wykonany aktualny proces
! 		(je¶li nie podano argumentu) lub proces o numerze PID ,,pid''.
! 	RETURN:	Numer GID lub -1 je¶li wyst±pi³ b³±d.
! 	DOC:	stat(2), chown(2), chown(8)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
! 		EFAULT	- Argument ,,path'' jest równy NULL.
! 		[ Wszystkie jakie mo¿e zwróciæ namei(9) lub VOP_GETATTR(9). ]
  
! UDEF:getmode([STR:path|UDEF:pid])
! 	DESC:	Podaje prawa dostêpu do podanego pliku (je¶li argument jest typu
! 		STR), pliku, z którego zosta³ wykonany aktualny proces (je¶li
! 		nie podano argumentu) lub proces o numerze PID ,,pid''.
! 	RETURN:	Prawa dostêpu lub -1 je¶li wyst±pi³ b³±d.
! 	DOC:	stat(2), chmod(1), chmod(2)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
! 		EFAULT	- Argument ,,path'' jest równy NULL.
! 		[ Wszystkie jakie mo¿e zwróciæ namei(9) lub VOP_GETATTR(9). ]
  
! UDEF:getflags([STR:path|UDEF:pid])
! 	DESC:	Podaje flagi dla podanego pliku (je¶li argument jest typu STR),
! 		pliku, z którego zosta³ wykonany aktualny proces (je¶li nie
! 		podano argumentu) lub proces o numerze PID ,,pid''.
! 	RETURN:	Prawa dostêpu lub -1 je¶li wyst±pi³ b³±d.
! 	DOC:	stat(2), chflags(1), chflags(2)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
! 		EFAULT	- Argument ,,path'' jest równy NULL.
! 		[ Wszystkie jakie mo¿e zwróciæ namei(9) lub VOP_GETATTR(9). ]
  
! UDEF:getnlinks([STR:path|UDEF:pid])
! 	DESC:	Podaje ilo¶æ dowi±zañ do podanego pliku (je¶li argument jest
! 		typu STR), pliku, z którego zosta³ wykonany aktualny proces
! 		(je¶li nie podano argumentu) lub proces o numerze PID ,,pid''.
! 	RETURN:	Ilo¶æ dowi±zañ lub -1 je¶li wyst±pi³ b³±d.
! 	DOC:	stat(2), ln(1), link(2)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
! 		EFAULT	- Argument ,,path'' jest równy NULL.
! 		[ Wszystkie jakie mo¿e zwróciæ namei(9) lub VOP_GETATTR(9). ]
  
! UDEF:getsize([STR:path|UDEF:pid])
! 	DESC:	Podaje rozmiar podanego pliku (je¶li argument jest typu STR),
! 		pliku, z którego zosta³ wykonany aktualny proces (je¶li nie
! 		podano argumentu) lub proces o numerze PID ,,pid''.
! 	RETURN:	Rozmiar pliku lub -1 je¶li wyst±pi³ b³±d.
! 	DOC:	stat(2)
! 	CONFERR:
! 		EINVAL	- Niepoprawna liczba argumentów lub typ argumentu.
! 	ERROR:
! 		ESRCH	- Nie ma procesu o numerze PID ,,pid''.
! 		EFAULT	- Argument ,,path'' jest równy NULL.
! 		[ Wszystkie jakie mo¿e zwróciæ namei(9) lub VOP_GETATTR(9). ]
  
  fdcache(<DEF:fd>,<STR:name>)