head	1.2;
access;
symbols;
locks; strict;
comment	@# @;


1.2
date	97.05.04.05.32.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.2
log
@fixed title name
@
text
@.\"
.\" $Id: cap_copy_ext.3,v 1.1 1997/04/28 00:54:52 morgan Exp morgan $
.\"
.TH CAP_COPY_EXT 3 "26th April 1997" "" "Linux Programmer's Manual"
.SH NAME
cap_copy_ext, cap_size, cap_copy_int \- external representation of capability sets
.SH SYNOPSIS
.B #include <sys/capability.h>
.sp
.BI "ssize_t cap_copy_ext(void *" extrep ", cap_t " caps ", ssize_t " length );
.sp
.BI "ssize_t cap_size(cap_t " caps );
.sp
.BI "cap_t cap_copy_int(void const *" extrep );
.SH DESCRIPTION
These functions provide an external representation of POSIX.1e capabilities,
suitable for storage in archives or communication over pipes, for example.
.PP
.B cap_copy_ext
copies the capability sets
.I caps
into the buffer
.I extrep
(of length
.IR length ),
and returns indicating how much of the buffer was actually used.
.PP
.B cap_size
returns indicating how large a buffer would be required to fully represent
the capability set
.IR caps .
.PP
.B cap_copy_int
takes a buffer
.IR extrep ,
whose contents are the result of a
.B cap_copy_ext
call, and
reforms it into an internal-format capability set.
The return value must eventually be disposed of by passing it to
.BR cap_free .
.SH "RETURN VALUE"
.B cap_copy_int
returns a non-NULL value on success, and NULL on failure.
.PP
On failure,
.BR errno (3)
is set to
.BR EINVAL ,
or
.BR ENOMEM .
.SH "CONFORMING TO"
These functions are specified by POSIX.1e.
.SH "SEE ALSO"
.IR cap_clear (3),
.IR cap_from_text (3),
.IR cap_get_file (3),
.IR cap_get_proc (3),
.IR cap_init (3)
@


1.1
log
@Initial revision
@
text
@d2 1
a2 1
.\" $Id$
d4 1
a4 1
.TH CAP_INIT 3 "26th April 1997" "" "Linux Programmer's Manual"
@
