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_chmod3

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.