7510 enable highres clock usage for non-privileged users

Reviewed by: Bryan Cantrill <bryan@joyent.com>
Reviewed by: Patrick Mooney <patrick.mooney@joyent.com>
Reviewed by: Robert Mustacchi <rm@joyent.com>
Reviewed by: Yuri Pankov <ypankov@tintri.com>
Approved by: Richard Lowe <richlowe@richlowe.net>

1 files changed, 9 insertions, 12 deletions

diff --git a/usr/src/man/man3c/timer_settime.3c b/usr/src/man/man3c/timer_settime.3c
index de4c0599a2..3813a9d86d 100644
--- a/usr/src/man/man3c/timer_settime.3c
+++ b/usr/src/man/man3c/timer_settime.3c
@@ -43,12 +43,12 @@
 .\" Copyright 1989 AT&T
 .\" Portions Copyright (c) 1992, X/Open Company Limited.  All Rights Reserved.
 .\" Copyright (c) 2008, Sun Microsystems, Inc.  All Rights Reserved.
+.\" Copyright 2016, Joyent, Inc.
 .\"
-.TH TIMER_SETTIME 3C "Feb 5, 2008"
+.TH TIMER_SETTIME 3C "Mar 24, 2016"
 .SH NAME
 timer_settime, timer_gettime, timer_getoverrun \- per-process timers
 .SH SYNOPSIS
-.LP
 .nf
 #include <time.h>
 
@@ -68,8 +68,6 @@ timer_settime, timer_gettime, timer_getoverrun \- per-process timers
 .fi
 
 .SH DESCRIPTION
-.sp
-.LP
 The \fBtimer_settime()\fR function sets the time until the next expiration of
 the timer specified by \fItimerid\fR from the \fBit_value\fR member of the
 \fIvalue\fR argument and arm the timer if the \fBit_value\fR member of
@@ -138,17 +136,19 @@ set to \fBDELAYTIMER_MAX\fR. The value returned by \fBtimer_getoverrun()\fR
 applies to the most recent expiration signal delivery or acceptance for the
 timer. If no expiration signal has been delivered for the timer, the meaning of
 the overrun count returned is undefined.
-.SH RETURN VALUES
 .sp
 .LP
+If the specified timer is of type \fBCLOCK_HIGHRES\fR and the time value is
+smaller than a system defined threshold, then {\fBPRIV_PROC_CLOCK_HIGHRES\fR}
+must be asserted in the effective set of the calling process or the time values
+will be adjusted up to the threshold value.
+.SH RETURN VALUES
 If the \fBtimer_settime()\fR or \fBtimer_gettime()\fR functions succeed,
 \fB0\fR is returned. If an error occurs for either of these functions,
 \fB\(mi1\fR is returned, and \fBerrno\fR is set to indicate the error. If the
 \fBtimer_getoverrun()\fR function succeeds, it returns the timer expiration
 overrun count as explained above.
 .SH ERRORS
-.sp
-.LP
 The \fBtimer_settime()\fR, \fBtimer_gettime()\fR and \fBtimer_getoverrun()\fR
 functions will fail if:
 .sp
@@ -183,8 +183,6 @@ than or equal to 1000 million.
 .RE
 
 .SH ATTRIBUTES
-.sp
-.LP
 See \fBattributes\fR(5) for descriptions of the following attributes:
 .sp
 
@@ -203,7 +201,6 @@ Standard	See \fBstandards\fR(5).
 .TE
 
 .SH SEE ALSO
-.sp
-.LP
 \fBtime.h\fR(3HEAD), \fBclock_settime\fR(3C), \fBtimer_create\fR(3C),
-\fBtimer_delete\fR(3C), \fBattributes\fR(5), \fBstandards\fR(5)
+\fBtimer_delete\fR(3C), \fBattributes\fR(5), \fBprivileges\fR(5),
+\fBstandards\fR(5)