.\" @(#)$RCSfile: lfc_rmusrmap.man,v $ $Revision: 1.2 $ $Date: 2006/01/12 16:29:33 $ CERN IT-GD/SC Jean-Philippe Baud
.\" Copyright (C) 2005 by CERN/IT/GD/SC
.\" All rights reserved
.\"
.TH LFC_RMUSRMAP 3 "$Date: 2006/01/12 16:29:33 $" LFC "LFC Library Functions"
.SH NAME
lfc_rmusrmap \- suppress user entry corresponding to a given virtual uid or user name
.SH SYNOPSIS
.B #include <sys/types.h>
.br
\fB#include "lfc_api.h"\fR
.sp
.BI "int lfc_rmusrmap (uid_t " uid ,
.BI "char *" username )
.SH DESCRIPTION
.B lfc_rmusrmap
suppresses the user entry corresponding to a given virtual uid or user name.
If both are specified, they must point at the same entry.
.TP
.I uid
specifies the Virtual User Id.
.TP
.I username
specifies the user name.
.LP
This function requires ADMIN privilege.
.SH RETURN VALUE
This routine returns 0 if the operation was successful or -1 if the operation
failed. In the latter case,
.B serrno
is set appropriately.
.SH ERRORS
.TP 1.3i
.B EACCES
The caller does not have ADMIN privilege.
.TP
.B EINVAL
This user does not exist in the internal mapping table or the length of
.I username
exceeds 255 or
.I uid
and
.I username
do not point at the same entry.
.TP
.B SENOSHOST
Host unknown.
.TP
.B SENOSSERV
Service unknown.
.TP
.B SECOMERR
Communication error.
.TP
.B ENSNACT
Name server is not running or is being shutdown.