


     nice(XOPEN.os/proceRelease	4.4.1 (UniSoft Lnice(XOPEN.os/procenv)



     NAME
	  XOPEN.os/procenv/nice	- change priority of a process testset

     DESCRIPTION
	  Nice tests the nice()	system call interface for conformance
	  to the XSI System Interfaces Page:nice()

     TESTS
     Compliance
	  1    The current process's nice value	is a positive number
	       between 0 and 2*[NZERO]-1.

	  2    The new nice value minus	NZERO is returned to the
	       process if call successfully completed.

	  3    The nice	value associated with a	process	is inherited
	       across fork() system calls.

	  4    The nice	value associated with a	process	is inherited
	       across exec() system calls.

	  5    The nice	value is correctly set when incr is a positive
	       integer and that	the resulting nice value stays below
	       the maximium limit of 2*[NZERO]-1.

	  6    The nice	value is correctly set by super-user when incr
	       is a negative integer and that the resulting nice value
	       stays above the minimum limit of	0.

	  7    The nice	value is correctly set when incr is a positive
	       integer and that	the request would exceed the maximum
	       limit of	2*[NZERO]-1.

	  8    setting of the correct nice value by super-user when
	       incr is a negative integer and that the request would
	       be less than the	minimum	limit of 0.

     Deviance
	  9    EPERM in	errno, nice value unchanged and	-1 returned by
	       nice() if incr is negative or greater than 2*[NZERO]
	       and the effective user ID of the	calling	process	is not
	       super-user.

     Untestable	Aspects
	  1    processes with lower nice values	should have higher CPU
	       priorities
	       Reason for omission: there is no	method of measuring
	       the variation in	CPU priorities and the results could
	       be very implementation dependent.

     SPECIAL CONDITIONS
	  1    Super-user privileges required to run tests 3 and 5.



     Page 1					    (printed 2/21/103)






     nice(XOPEN.os/proceRelease	4.4.1 (UniSoft Lnice(XOPEN.os/procenv)



     OUTPUTS
     Tests:
	  1-4  Pass/Fail indication - failure information includes
	       expected	and detected nice values.

	  5    Pass/Fail indication - failure information includes
	       expected	and detected errno.

     DELETIONS
	  Tests	6 and 8	will be	deleted	if the effective user-ID of
	  the calling process is not super-user.

     PARAMETERS
	  1    VSX_NICE	: if defined, tests in the nice	testset	are
	       performed.

     SEE ALSO
	  exec(2), fork(os.knl/proc), exec(os.knl/proc).

     AUTHOR
	  Manucher Ghezel-Ayagh, UniSoft Ltd.

     RELEASE
	  4.4.1	(06/09/97)































     Page 2					    (printed 2/21/103)



