diff options
Diffstat (limited to 'doc/old')
-rw-r--r-- | doc/old/RCS/README,v | 25 | ||||
-rw-r--r-- | doc/old/RCS/_fgetfilecap.2,v | 25 | ||||
-rw-r--r-- | doc/old/RCS/_fsetfilecap.2,v | 25 | ||||
-rw-r--r-- | doc/old/RCS/_getfilecap.2,v | 25 | ||||
-rw-r--r-- | doc/old/RCS/_getproccap.2,v | 25 | ||||
-rw-r--r-- | doc/old/RCS/_setfilecap.2,v | 141 | ||||
-rw-r--r-- | doc/old/RCS/_setproccap.2,v | 76 | ||||
-rw-r--r-- | doc/old/RCS/cap_get_file.3,v | 202 | ||||
-rw-r--r-- | doc/old/RCS/getcap.8,v | 42 | ||||
-rw-r--r-- | doc/old/RCS/setcap.8,v | 51 | ||||
-rw-r--r-- | doc/old/_setfilecap.2 | 2 | ||||
-rw-r--r-- | doc/old/_setproccap.2 | 2 | ||||
-rw-r--r-- | doc/old/cap_get_file.3 | 2 | ||||
-rw-r--r-- | doc/old/getcap.8 | 2 | ||||
-rw-r--r-- | doc/old/setcap.8 | 2 |
15 files changed, 5 insertions, 642 deletions
diff --git a/doc/old/RCS/README,v b/doc/old/RCS/README,v deleted file mode 100644 index 8e261fc..0000000 --- a/doc/old/RCS/README,v +++ /dev/null @@ -1,25 +0,0 @@ -head 1.1; -access; -symbols; -locks; strict; -comment @# @; - - -1.1 -date 98.05.24.22.50.55; author morgan; state Exp; -branches; -next ; - - -desc -@description of this directory -@ - - -1.1 -log -@Initial revision -@ -text -@these files are not relevant to this release -@ diff --git a/doc/old/RCS/_fgetfilecap.2,v b/doc/old/RCS/_fgetfilecap.2,v deleted file mode 100644 index d5d976f..0000000 --- a/doc/old/RCS/_fgetfilecap.2,v +++ /dev/null @@ -1,25 +0,0 @@ -head 1.1; -access; -symbols; -locks; strict; -comment @# @; - - -1.1 -date 97.04.28.00.54.52; author morgan; state Exp; -branches; -next ; - - -desc -@zefram's manual -@ - - -1.1 -log -@Initial revision -@ -text -@.so man2/_setfilecap.2 -@ diff --git a/doc/old/RCS/_fsetfilecap.2,v b/doc/old/RCS/_fsetfilecap.2,v deleted file mode 100644 index d5d976f..0000000 --- a/doc/old/RCS/_fsetfilecap.2,v +++ /dev/null @@ -1,25 +0,0 @@ -head 1.1; -access; -symbols; -locks; strict; -comment @# @; - - -1.1 -date 97.04.28.00.54.52; author morgan; state Exp; -branches; -next ; - - -desc -@zefram's manual -@ - - -1.1 -log -@Initial revision -@ -text -@.so man2/_setfilecap.2 -@ diff --git a/doc/old/RCS/_getfilecap.2,v b/doc/old/RCS/_getfilecap.2,v deleted file mode 100644 index d5d976f..0000000 --- a/doc/old/RCS/_getfilecap.2,v +++ /dev/null @@ -1,25 +0,0 @@ -head 1.1; -access; -symbols; -locks; strict; -comment @# @; - - -1.1 -date 97.04.28.00.54.52; author morgan; state Exp; -branches; -next ; - - -desc -@zefram's manual -@ - - -1.1 -log -@Initial revision -@ -text -@.so man2/_setfilecap.2 -@ diff --git a/doc/old/RCS/_getproccap.2,v b/doc/old/RCS/_getproccap.2,v deleted file mode 100644 index 7b92324..0000000 --- a/doc/old/RCS/_getproccap.2,v +++ /dev/null @@ -1,25 +0,0 @@ -head 1.1; -access; -symbols; -locks; strict; -comment @# @; - - -1.1 -date 97.04.28.00.54.52; author morgan; state Exp; -branches; -next ; - - -desc -@zefram's manual -@ - - -1.1 -log -@Initial revision -@ -text -@.so man2/_setproccap.2 -@ diff --git a/doc/old/RCS/_setfilecap.2,v b/doc/old/RCS/_setfilecap.2,v deleted file mode 100644 index 61c8351..0000000 --- a/doc/old/RCS/_setfilecap.2,v +++ /dev/null @@ -1,141 +0,0 @@ -head 1.1; -access; -symbols; -locks; strict; -comment @# @; - - -1.1 -date 97.04.28.00.54.52; author morgan; state Exp; -branches; -next ; - - -desc -@zefram's manual -@ - - -1.1 -log -@Initial revision -@ -text -@.\" -.\" $Id$ -.\" written by Andrew Main <zefram@@dcs.warwick.ac.uk> -.\" -.TH _SETFILECAP 2 "26th April 1997" "Linux 2.1" "Linux Programmer's Manual" -.SH NAME -_setfilecap, _getfilecap, _fsetfilecap, _fgetfilecap \- set/get file capabilities -.SH SYNOPSIS -.B #include <sys/capability.h> -.sp -.BI "int _setfilecap(char const *" filename ", size_t " usize ", __cap_s const *" iset ", __cap_s const *" pset ", __cap_s const *" eset ); -.sp -.BI "int _getproccap(char const *" filename ", size_t " usize ", __cap_s *" iset ", __cap_s *" pset ", __cap_s *" eset ); -.sp -.BI "int _fsetfilecap(int " fd ", size_t " usize ", __cap_s const *" iset ", __cap_s const *" pset ", __cap_s const *" eset ); -.sp -.BI "int _fgetproccap(int " fd ", size_t " usize ", __cap_s *" iset ", __cap_s *" pset ", __cap_s *" eset ); -.SH USAGE -.br -.B cc ... -lcap -.SH DESCRIPTION -.B _setfilecap -sets the specified -.IR filename 's -Inheritable, Permitted and Effective capabilities to the sets specified. -A NULL pointer specifies that a set should not be changed. -.PP -.B _fsetfilecap -does the same thing to the file referenced by file descriptor -.IR fd . -.PP -.B _getfilecap -and -.B _fgetfilecap -copy the file's capability sets into the sets provided. -A NULL pointer specifies that a set should not be returned. -.PP -The -.I usize -argument specifies the size of the user-space capability sets, in bytes. -If the kernel uses a different size internally, it will truncate or -zero-fill as required. -.PP -Files don't actually have a proper Effective capability set. Instead they -have a single-bit flag, that indicates that the set is either full or -empty. When setting a file's capabilities, that flag will be set if -and only if the Effective set specified has at least one bit set. -.SH "RETURN VALUE" -On success, zero is returned. On error, -1 is returned, and -.I errno -is set appropriately. -.SH ERRORS -.TP -.SB EFAULT -One of the capability arguments or the filename was an invalid data pointer. -.TP -.SB EPERM -An attempt was made to set non-empty capabilities on a file, -and the caller does not have the -.SB CAP_FSETCAP -capability raised. -.TP -.SB EPERM -An attempt was made to set capabilities on a file, and -the effective UID does not match the owner of the file, and the caller -does not have the -.SB CAP_FOWNER -capability raised. -.TP -.SB EINVAL -An attempt was made to set non-empty capabilities on a file -residing on a file system that does not support them. -.TP -.SB EROFS -An attempt was made to set capabilities on a file residing -on a read-only file system. -.TP -.SB ENAMETOOLONG -.I filename -is too long. -.TP -.SB ENOENT -The file specified does not exist. -.TP -.SB ENOMEM -Insufficient kernel memory was available. -.TP -.SB ENOTDIR -A component of the path prefix is not a directory. -.TP -.SB EACCES -Search permission is denied on a component of the path prefix. -.TP -.SB ELOOP -.I filename -containes a circular reference (via symlinks). -.TP -.SB EBADF -.I fd -is not a valid file descriptor. -.TP -.SB EIO -A hard error occurred while reading or writing the file system. -.TP -.SB ENOSYS -The POSIX.1e capability system was not configured into the kernel. -.SH "CONFORMING TO" -These system calls are specific to Linux. -The portable interfaces are -.IR cap_set_file (3), -.IR cap_get_file (3), -.IR cap_set_fd (3), -and -.IR cap_get_fd (3). -.SH "SEE ALSO" -.IR _setproccap (2). - -@ diff --git a/doc/old/RCS/_setproccap.2,v b/doc/old/RCS/_setproccap.2,v deleted file mode 100644 index 8c3084b..0000000 --- a/doc/old/RCS/_setproccap.2,v +++ /dev/null @@ -1,76 +0,0 @@ -head 1.1; -access; -symbols; -locks; strict; -comment @# @; - - -1.1 -date 97.04.28.00.54.52; author morgan; state Exp; -branches; -next ; - - -desc -@zefram's manual -@ - - -1.1 -log -@Initial revision -@ -text -@.\" -.\" $Id$ -.\" written by Andrew Main <zefram@@dcs.warwick.ac.uk> -.\" -.TH _SETPROCCAP 2 "26th April 1997" "Linux 2.1" "Linux Programmer's Manual" -.SH NAME -_setproccap, _getproccap \- set/get process capabilities -.SH SYNOPSIS -.B #include <sys/capability.h> -.sp -.BI "int _setproccap(size_t " usize ", __cap_s const *" iset ", __cap_s const *" pset ", __cap_s const *" eset ); -.sp -.BI "int _getproccap(size_t " usize ", __cap_s *" iset ", __cap_s *" pset ", __cap_s *" eset ); -.SH DESCRIPTION -.B _setproccap -sets the calling process' -Inheritable, Permitted and Effective capabilities to the sets specified. -A NULL pointer specifies that a set should not be changed. -.PP -.B _getproccap -copies the process' capability sets into the sets provided. -A NULL pointer specifies that a set should not be returned. -.PP -The -.I usize -argument specifies the size of the user-space capability sets, in bytes. -If the kernel uses a different size internally, it will truncate or -zero-fill as required. -.SH "RETURN VALUE" -On success, zero is returned. On error, -1 is returned, and -.I errno -is set appropriately. -.SH ERRORS -.TP -.SB EFAULT -One of the capability arguments was an invalid data pointer. -.TP -.SB EPERM -An attempt was made to add a capability to the Permitted set, or to set -a capability in the Effective or Inheritable sets that is not in the -Permitted set. -.TP -.SB ENOSYS -The POSIX.1e capability system was not configured into the kernel. -.SH "CONFORMING TO" -These system calls are specific to Linux. -The portable interfaces are -.IR cap_set_proc (3) -and -.IR cap_get_proc (3). -.SH "SEE ALSO" -.IR _setfilecap (2). -@ diff --git a/doc/old/RCS/cap_get_file.3,v b/doc/old/RCS/cap_get_file.3,v deleted file mode 100644 index 6a57b4d..0000000 --- a/doc/old/RCS/cap_get_file.3,v +++ /dev/null @@ -1,202 +0,0 @@ -head 1.4; -access; -symbols; -locks; strict; -comment @# @; - - -1.4 -date 98.05.17.17.40.28; author morgan; state Exp; -branches; -next 1.3; - -1.3 -date 98.05.17.17.39.20; author morgan; state Exp; -branches; -next 1.2; - -1.2 -date 97.05.24.19.45.28; author morgan; state Exp; -branches; -next 1.1; - -1.1 -date 97.04.28.00.54.52; author morgan; state Exp; -branches; -next ; - - -desc -@zefram's manual -@ - - -1.4 -log -@changed date of file -@ -text -@.\" -.\" $Id: cap_get_file.3,v 1.3 1998/05/17 17:39:20 morgan Exp morgan $ -.\" written by Andrew Main <zefram@@dcs.warwick.ac.uk> -.\" -.TH CAP_GET_FILE 3 "17th May 1998" "" "Linux Programmer's Manual" -.SH NAME -cap_get_file, cap_set_file, cap_get_fd, cap_set_fd \- capability manipulation on files -.sp -.B " PLEASE NOTE NONE OF THESE FUNCTIONS ARE IMPLEMENTED IN 0.102. NEITHER IS THERE SUPPORT FOR THEM IN LINUX 2.1.102." -.SH SYNOPSIS -.B -.sp -.B #include <sys/capability.h> -.sp -.BI "cap_t cap_get_file(const char *" path_p ); -.sp -.BI "int cap_set_file(const char *" path_p ", cap_t " cap_p ); -.sp -.BI "cap_t cap_get_fd(int " fd ); -.sp -.BI "int cap_set_fd(int " fd ", cap_t " caps ); -.SH USAGE -.br -.B cc ... -lcap -.SH DESCRIPTION -.B cap_get_file -and -.B cap_get_fd -allocate a capability state in working storage and set it to represent the -capability state of the pathname pointed to by -.I path_p -or the file open on descriptor -.IR fd . -These functions return a pointer to the newly created capability -state. The effects of reading the capability state from any file -other than a regular file is undefined. The caller should free any -releasable memory, when the capability state in working storage is no -longer required, by calling -.B cap_free -with the used -.I cap_t -as an argument. -.PP -.B cap_set_file -and -.B cap_set_fd -set the values for all capability flags for all capabilities for the pathname -pointed to by -.I path_p -or the file open on descriptor -.IR fd , -with the capability state identified by -.IR cap_p . -The new capability state of the file shall be completely determined by the -contents of -.IR cap_p . -For these functions to succeed, the calling process must have the -.B CAP_SETFCAP -capability enabled and either the effective user ID of the process must match -the file owner or the calling process must have the effective flag of the -.B CAP_FOWNER -capability set. The effects of writing the capability state to any file -type other than a regular file are undefined. -.SH "RETURN VALUE" -.B cap_get_file -and -.B cap_get_fd -return a non-NULL value on success, and NULL on failure. -.PP -.B cap_set_file -and -.B cap_set_fd -return zero on success, and \-1 on failure. -.PP -On failure, -.BR errno (3) -is set to -.BR EACCES , -.BR EBADFD , -.BR ENAMETOOLONG , -.BR ENOENT , -.BR ENOMEM , -.BR ENOTDIR , -.BR EPERM , -or -.BR EROFS . -.SH "CONFORMING TO" -These functions are specified by POSIX.1e. -.SH "SEE ALSO" -.IR cap_clear (3), -.IR cap_copy_ext (3), -.IR cap_from_text (3), -.IR cap_get_proc (3), -.IR cap_init (3) -@ - - -1.3 -log -@added comment about the fact that none of these functions are -currently implemented -@ -text -@d2 1 -a2 1 -.\" $Id: cap_get_file.3,v 1.2 1997/05/24 19:45:28 morgan Exp morgan $ -d5 1 -a5 1 -.TH CAP_GET_FILE 3 "26th May 1997" "" "Linux Programmer's Manual" -@ - - -1.2 -log -@corrections from Aleph1 -@ -text -@d2 1 -a2 1 -.\" $Id: cap_get_file.3,v 1.1 1997/04/28 00:54:52 morgan Exp morgan $ -d8 2 -d11 2 -@ - - -1.1 -log -@Initial revision -@ -text -@d2 1 -a2 1 -.\" $Id$ -d5 1 -a5 1 -.TH CAP_GET_FILE 3 "26th April 1997" "" "Linux Programmer's Manual" -d7 1 -a7 1 -cap_get_file, cap_set_file, cap_get_fd, cap_set_fd \- get/set capabilities of files -d11 1 -a11 1 -.BI "cap_t cap_get_file(char const *" filename ); -d13 1 -a13 1 -.BI "int cap_set_file(char const *" filename ", cap_t " caps ); -d25 4 -a28 3 -return the capability sets of the file specified by -.I filename -or -d30 9 -a38 2 -The returned value must later be disposed of by passing it to -.BR cap_free . -d43 17 -a59 6 -set the capabilities of the file specified by -.I filename -or -.I fd -to -.IR caps . -d70 13 -@ diff --git a/doc/old/RCS/getcap.8,v b/doc/old/RCS/getcap.8,v deleted file mode 100644 index 817d0a4..0000000 --- a/doc/old/RCS/getcap.8,v +++ /dev/null @@ -1,42 +0,0 @@ -head 1.1; -access; -symbols; -locks; strict; -comment @# @; - - -1.1 -date 97.04.28.00.54.52; author morgan; state Exp; -branches; -next ; - - -desc -@zefram's manual -@ - - -1.1 -log -@Initial revision -@ -text -@.\" -.\" $Id$ -.\" written by Andrew Main <zefram@@dcs.warwick.ac.uk> -.\" -.TH GETCAP 8 "26th April 1997" -.SH NAME -getcap \- examine file capabilities -.SH SYNOPSIS -\fBgetcap\fP \fIfilename\fP [ ... ] -.SH DESCRIPTION -.B getcap -displays the name and capabilities of each specified -.IR filename . -One file per line. -.SH "SEE ALSO" -.IR cap_get_file (3), -.IR cap_to_text (3), -.IR setcap (8) -@ diff --git a/doc/old/RCS/setcap.8,v b/doc/old/RCS/setcap.8,v deleted file mode 100644 index 380f126..0000000 --- a/doc/old/RCS/setcap.8,v +++ /dev/null @@ -1,51 +0,0 @@ -head 1.1; -access; -symbols; -locks; strict; -comment @# @; - - -1.1 -date 97.04.28.00.54.52; author morgan; state Exp; -branches; -next ; - - -desc -@zefram's manual -@ - - -1.1 -log -@Initial revision -@ -text -@.\" -.\" $Id$ -.\" -.TH SETCAP 8 "26th April 1997" -.SH NAME -setcap \- set file capabilities -.SH SYNOPSIS -\fBsetcap\fP \fIcapabilities filename\fP [ ... \fIcapabilitiesN\fP \fIfileN\fP ] -.SH DESCRIPTION -.B setcap -sets the capabilities of each specified -.I filename -to the -.I capabilities -specified. The -.I capabilities -are specified in the form described in -.IR cap_from_text (3). -.PP -The special filename, '\-', -can be used to indicate that capabilities are read from the standard -input. In such cases, the capability set is terminated with a blank -line. -.SH "SEE ALSO" -.IR cap_from_text (3), -.IR cap_set_file (3), -.IR getcap (8) -@ diff --git a/doc/old/_setfilecap.2 b/doc/old/_setfilecap.2 index d4a9e6b..6a0538c 100644 --- a/doc/old/_setfilecap.2 +++ b/doc/old/_setfilecap.2 @@ -1,5 +1,5 @@ .\" -.\" $Id: _setfilecap.2,v 1.1 1997/04/28 00:54:52 morgan Exp $ +.\" $Id: _setfilecap.2,v 1.1.1.1 1999/04/17 22:16:31 morgan Exp $ .\" written by Andrew Main <zefram@dcs.warwick.ac.uk> .\" .TH _SETFILECAP 2 "26th April 1997" "Linux 2.1" "Linux Programmer's Manual" diff --git a/doc/old/_setproccap.2 b/doc/old/_setproccap.2 index f48b521..d4579c8 100644 --- a/doc/old/_setproccap.2 +++ b/doc/old/_setproccap.2 @@ -1,5 +1,5 @@ .\" -.\" $Id: _setproccap.2,v 1.1 1997/04/28 00:54:52 morgan Exp $ +.\" $Id: _setproccap.2,v 1.1.1.1 1999/04/17 22:16:31 morgan Exp $ .\" written by Andrew Main <zefram@dcs.warwick.ac.uk> .\" .TH _SETPROCCAP 2 "26th April 1997" "Linux 2.1" "Linux Programmer's Manual" diff --git a/doc/old/cap_get_file.3 b/doc/old/cap_get_file.3 index cb84c2b..e2eb626 100644 --- a/doc/old/cap_get_file.3 +++ b/doc/old/cap_get_file.3 @@ -1,5 +1,5 @@ .\" -.\" $Id: cap_get_file.3,v 1.4 1998/05/17 17:40:28 morgan Exp $ +.\" $Id: cap_get_file.3,v 1.1.1.1 1999/04/17 22:16:31 morgan Exp $ .\" written by Andrew Main <zefram@dcs.warwick.ac.uk> .\" .TH CAP_GET_FILE 3 "17th May 1998" "" "Linux Programmer's Manual" diff --git a/doc/old/getcap.8 b/doc/old/getcap.8 index 65674ab..a0e2c41 100644 --- a/doc/old/getcap.8 +++ b/doc/old/getcap.8 @@ -1,5 +1,5 @@ .\" -.\" $Id: getcap.8,v 1.1 1997/04/28 00:54:52 morgan Exp $ +.\" $Id: getcap.8,v 1.1.1.1 1999/04/17 22:16:31 morgan Exp $ .\" written by Andrew Main <zefram@dcs.warwick.ac.uk> .\" .TH GETCAP 8 "26th April 1997" diff --git a/doc/old/setcap.8 b/doc/old/setcap.8 index d8aaa90..1f727c1 100644 --- a/doc/old/setcap.8 +++ b/doc/old/setcap.8 @@ -1,5 +1,5 @@ .\" -.\" $Id: setcap.8,v 1.1 1997/04/28 00:54:52 morgan Exp $ +.\" $Id: setcap.8,v 1.1.1.1 1999/04/17 22:16:31 morgan Exp $ .\" .TH SETCAP 8 "26th April 1997" .SH NAME |