gbatch_newgrp - select new primary group

# NAME

gbatch_newgrp - select new primary group

# SYNOPSIS

#include <gbatch.h>

int gbatch_newgrp(const int fd, const char * group)

# DESCRIPTION

The function gbatch_newgrp is used to select a new primary group as the user's primary group.

fd is a file descriptor which was previously returned by a successful call to `gbatch_open(3)`.

group is the required group name to be selected. If the user has write admin file privilege, this may be any valid group name, otherwise the group must be the user's default groupp or one of the user's supplementary groups.

# RETURN VALUES

The function returns 0 if successful, otherwise an error code as defined in the include file \fBgbatch.h\fR.

# SEE ALSO

`gbatch_open(3)`, `gbatch_close(3)`, `gbatch_jobmon(3)`, `gbatch_varmon(3)`.

# COPYRIGHT

Copyright (c) 2009 Free Software Foundation, Inc. This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.

# AUTHOR

John M Collins, Xi Software Ltd.