.ig
 Copyright (C) 1993,1994 by the author(s).
 
 This software is published in the hope that it will be useful, but
 WITHOUT ANY WARRANTY for any part of this software to work correctly
 or as described in the manuals. See the ShapeTools Public License
 for details.

 Permission is granted to use, copy, modify, or distribute any part of
 this software but only under the conditions described in the ShapeTools 
 Public License. A copy of this license is supposed to have been given
 to you along with ShapeTools in a file named LICENSE. Among other
 things, this copyright notice and the Public License must be
 preserved on all copies.


Author: Andreas Lampen (Andreas.Lampen@cs.tu-berlin.de)

$Header: af_protect.3[7.0] Fri Jun 25 14:33:16 1993 andy@cs.tu-berlin.de frozen $
..
.TH af_protect 3 "Fri Jun 25 14:33:16 1993" "AtFS-1.71" "Attribute Filesystem (AtFS)"
.SH NAME
af_chowner, af_chauthor, af_chmod \- AtFS protection handling
.SH SYNOPSIS
#include <atfs.h>
.sp
int af_chowner (Af_key *aso, Af_user *owner)
.sp
int af_chauthor (Af_key *aso, Af_user *author)
.sp
int af_chmod (Af_key *aso, int mode)
.sp
.SH DESCRIPTION
\fIaf_chowner\fP and \fIaf_chauthor\fP modify the
owner and author attribute of an ASO.
Only the superuser may change the owner of an object history.
The author attribute of an ASO can only be changed by it's owner.
The Af_user structure has the following form
.LP
.RS
.nf
typedef struct {
	char	af_username[\s-1MAXUSERNAMELEN\s+1];
	char	af_userhost[\s-1MAXHOSTNAMELEN\s+1];
	char	af_userdomain[\s-1MAXDOMAIN+1\s+1];
	} Af_user;
.fi
.RE
.LP
\fIaf_chmod\fP changes the mode of an ASO.
See chmod(3) for further details.
.SH SEE ALSO
chown (2), chmod (2)
.SH DIAGNOSTICS
Upon error, \-1 is returned and \fIaf_errno\fP is set to the
corresponding error number.
.SH BUGS
\fIaf_chowner\fP does not work.