hostPartUserInfo Struct Reference

gets user information about host partitions. More...

Data Fields
char *	user
int	shares
float	priority
int	numStartJobs
float	histCpuTime
int	numReserveJobs
int	runTime
float	shareAdjustment

---

Detailed Description

gets user information about host partitions.

---

Field Documentation

char* hostPartUserInfo::user

The user name or user group name.

See lsb_userinfo and lsb_usergrpinfo

int hostPartUserInfo::shares

The number of shares assigned to the user or user group, as configured in the file lsb.hosts.

(See lsb.hosts.)

float hostPartUserInfo::priority

The priority of the user or user group to use the host partition.

Bigger values represent higher priorities. Jobs belonging to the user or user group with the highest priority are considered first for dispatch when resources in the host partition are being contended for. In general, a user or user group with more shares, fewer numStartJobs and less histCpuTime has higher priority.

The storage for the array of hostPartInfoEnt structures will be reused by the next call.

int hostPartUserInfo::numStartJobs

The number of job slots belonging to the user or user group that are running or suspended in the host partition.

float hostPartUserInfo::histCpuTime

The normalized CPU time accumulated in the host partition during the recent period by finished jobs belonging to the user or user group.

The period may be configured in the file lsb.params (see lsb.params), with a default value of five (5) hours.

int hostPartUserInfo::numReserveJobs

The number of job slots that are reserved for the PEND jobs belonging to the user or user group in the host partition.

int hostPartUserInfo::runTime

The time unfinished jobs spend in RUN state.

float hostPartUserInfo::shareAdjustment

The fairshare adjustment value from the fairshare plugin (libfairshareadjust*).

The adjustment is enabled and weighted by setting the value of FAIRSHARE_ADJUSTMENT_FACTOR in lsb.params.