setgroups.2 (84306) | setgroups.2 (108028) |
---|---|
1.\" Copyright (c) 1983, 1991, 1993, 1994 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)setgroups.2 8.2 (Berkeley) 4/16/94 | 1.\" Copyright (c) 1983, 1991, 1993, 1994 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)setgroups.2 8.2 (Berkeley) 4/16/94 |
33.\" $FreeBSD: head/lib/libc/sys/setgroups.2 84306 2001-10-01 16:09:29Z ru $ | 33.\" $FreeBSD: head/lib/libc/sys/setgroups.2 108028 2002-12-18 09:22:32Z ru $ |
34.\" 35.Dd April 16, 1994 36.Dt SETGROUPS 2 37.Os 38.Sh NAME 39.Nm setgroups 40.Nd set group access list 41.Sh LIBRARY 42.Lb libc 43.Sh SYNOPSIS 44.In sys/param.h 45.In unistd.h 46.Ft int 47.Fn setgroups "int ngroups" "const gid_t *gidset" 48.Sh DESCRIPTION | 34.\" 35.Dd April 16, 1994 36.Dt SETGROUPS 2 37.Os 38.Sh NAME 39.Nm setgroups 40.Nd set group access list 41.Sh LIBRARY 42.Lb libc 43.Sh SYNOPSIS 44.In sys/param.h 45.In unistd.h 46.Ft int 47.Fn setgroups "int ngroups" "const gid_t *gidset" 48.Sh DESCRIPTION |
49.Fn Setgroups | 49The 50.Fn setgroups 51system call |
50sets the group access list of the current user process 51according to the array 52.Fa gidset . 53The parameter 54.Fa ngroups 55indicates the number of entries in the array and must be no 56more than 57.Dv NGROUPS , 58as defined in 59.Ao Pa sys/param.h Ac . 60.Pp 61Only the super-user may set new groups. 62.Sh RETURN VALUES 63.Rv -std setgroups 64.Sh ERRORS 65The 66.Fn setgroups | 52sets the group access list of the current user process 53according to the array 54.Fa gidset . 55The parameter 56.Fa ngroups 57indicates the number of entries in the array and must be no 58more than 59.Dv NGROUPS , 60as defined in 61.Ao Pa sys/param.h Ac . 62.Pp 63Only the super-user may set new groups. 64.Sh RETURN VALUES 65.Rv -std setgroups 66.Sh ERRORS 67The 68.Fn setgroups |
67call will fail if: | 69system call will fail if: |
68.Bl -tag -width Er 69.It Bq Er EPERM 70The caller is not the super-user. 71.It Bq Er EFAULT 72The address specified for 73.Fa gidset 74is outside the process 75address space. 76.El 77.Sh SEE ALSO 78.Xr getgroups 2 , 79.Xr initgroups 3 80.Sh HISTORY 81The 82.Fn setgroups | 70.Bl -tag -width Er 71.It Bq Er EPERM 72The caller is not the super-user. 73.It Bq Er EFAULT 74The address specified for 75.Fa gidset 76is outside the process 77address space. 78.El 79.Sh SEE ALSO 80.Xr getgroups 2 , 81.Xr initgroups 3 82.Sh HISTORY 83The 84.Fn setgroups |
83function call appeared in | 85system call appeared in |
84.Bx 4.2 . | 86.Bx 4.2 . |