mir/sudo
2
0
Fork 0
mirror of https://github.com/sudo-project/sudo.git synced 2025-08-31 14:25:15 +00:00
Code Issues Releases Wiki Activity

Replace timeleft with pending in sudo plugin event API.

Browse Source
This commit is contained in:
Todd C. Miller
2019-12-07 08:42:10 -07:00
parent bf3b93f080
commit d0b80b404c
4 changed files with 40 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
doc/sudo_plugin.man.in
View File

@@ -2459,7 +2459,8 @@ struct sudo_plugin_event {
sudo_plugin_ev_callback_t callback, void *closure);
int (*add)(struct sudo_plugin_event *pev, struct timespec *timeout);
int (*del)(struct sudo_plugin_event *pev);
int (*timeleft)(struct sudo_plugin_event *pev, struct timespec *ts);
int (*pending)(struct sudo_plugin_event *pev, int events,
struct timespec *ts);
int (*fd)(struct sudo_plugin_event *pev);
void (*setbase)(struct sudo_plugin_event *pev, void *base);
void (*loopbreak)(struct sudo_plugin_event *pev);
@@ -2634,25 +2635,30 @@ The
function returns 1 on success, and \-1 if a error occurred.
.RE
.TP 6n
\fBtimeleft\fR()
\fBpending\fR()
.nf
.RS 6n
int (*timeleft)(struct sudo_plugin_event *pev, struct timespec *ts);
int (*pending)(struct sudo_plugin_event *pev, int events, struct timespec *ts);
.RE
.fi
.RS 6n
.sp
The
\fBtimeleft\fR()
function can be used to determine how much time remains in an event's
timeout, if one was specified when the event was added.
\fBpending\fR()
function can be used to determine whether one or more events is pending.
The
\fIevents\fR
argument specifies which events to check for.
See the
\fBset\fR()
function for a list of valid event types.
If
\fRSUDO_PLUGIN_EV_TIMEOUT\fR
is specified in
\fRevents\fR,
the event has an associated timeout and the
\fIts\fR
pointer is filled in with the remaining time.
.sp
The
\fBtimeleft\fR()
function returns 1 on success, and \-1 if the event has no associated timeout.
pointer is non-NULL, it will be filled in with the remaining time.
.RE
.TP 6n
\fBfd\fR()