bproc_chown

Name

bproc_chown -- Change the ownership for a cluster node.

Synopsis

#include <sys/bproc.h>

int bproc_chown (int node, int user);

int bproc_chgrp (int node, int group);

int bproc_chown (int node, int user, int group);

Arguments

node

The node to change ownership of

user

The numeric user ID to assign to the node

group

The numeric group ID to assign to the node

Description

The owner of the cluster node is changed. The user specifies the desired user ID (UID). The second form, available only with the BProc v2 compatibility library, sets the group owner to group.

Previous BProc versions used the values BPROC_USER_ANY and BPROC_GROUP_ANY. The same effect can be achieved by setting world-execute permission using bproc_chmod(3)

See the Administrator's Guide for details of the semantics of node ownership and how the settings interact with schedulers.

Return Value

Returns 0 on success.

Returns -1 on error, and sets errno.

Errors

ENOSYS

The BProc system is not available.

EIO

The BProc system is loaded but not configured or active.

EPERM

This process does not have permission to change node ownership.

ENOMEM

Insufficient kernel memory was available to change ownership.

See Also

bproc_access(3), bproc_chgrp(3), bproc_chmod(3)