aboutsummaryrefslogtreecommitdiff
path: root/doc/old
diff options
context:
space:
mode:
Diffstat (limited to 'doc/old')
-rw-r--r--doc/old/RCS/README,v25
-rw-r--r--doc/old/RCS/_fgetfilecap.2,v25
-rw-r--r--doc/old/RCS/_fsetfilecap.2,v25
-rw-r--r--doc/old/RCS/_getfilecap.2,v25
-rw-r--r--doc/old/RCS/_getproccap.2,v25
-rw-r--r--doc/old/RCS/_setfilecap.2,v141
-rw-r--r--doc/old/RCS/_setproccap.2,v76
-rw-r--r--doc/old/RCS/cap_get_file.3,v202
-rw-r--r--doc/old/RCS/getcap.8,v42
-rw-r--r--doc/old/RCS/setcap.8,v51
-rw-r--r--doc/old/_setfilecap.22
-rw-r--r--doc/old/_setproccap.22
-rw-r--r--doc/old/cap_get_file.32
-rw-r--r--doc/old/getcap.82
-rw-r--r--doc/old/setcap.82
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