Page MenuHomeFreeBSD
Files F170932554

D59456.id186032.diff
No OneTemporary
Actions

D59456.id186032.diff
View Options

diff --git a/share/man/man9/callout.9 b/share/man/man9/callout.9
--- a/share/man/man9/callout.9
+++ b/share/man/man9/callout.9
@@ -35,6 +35,7 @@
.Nm callout_deactivate ,
.Nm callout_drain ,
.Nm callout_init ,
+.Nm callout_init_lock ,
.Nm callout_init_mtx ,
.Nm callout_init_rm ,
.Nm callout_init_rw ,
@@ -69,6 +70,8 @@
.Ft void
.Fn callout_init "struct callout *c" "int mpsafe"
.Ft void
+.Fn callout_init_lock "struct callout *c" "lock" "int flags"
+.Ft void
.Fn callout_init_mtx "struct callout *c" "struct mtx *mtx" "int flags"
.Ft void
.Fn callout_init_rm "struct callout *c" "struct rmlock *rm" "int flags"
@@ -192,11 +195,8 @@
or invoke any other action that might sleep.
.Pp
Each callout structure must be initialized by
-.Fn callout_init ,
-.Fn callout_init_mtx ,
-.Fn callout_init_rm ,
-or
-.Fn callout_init_rw
+.Fn callout_init or
+.Fn callout_init_lock
before it is passed to any of the other callout functions.
The
.Fn callout_init
@@ -212,19 +212,21 @@
and released when the callout function returns.
.Pp
The
+.Fn callout_init_lock
+function initializes a callout structure in
+.Fa c
+that is associated with a specific lock.
+The lock argument can be a pointer to either
+.Fa struct mtx ,
+.Fa struct rwlock
+or
+.Fa struct rmlock .
+Macros
.Fn callout_init_mtx ,
.Fn callout_init_rm ,
and
.Fn callout_init_rw
-functions initialize a callout structure in
-.Fa c
-that is associated with a specific lock.
-The lock is specified by the
-.Fa mtx ,
-.Fa rm ,
-or
-.Fa rw
-parameter.
+are provided for compatibility.
The associated lock must be held while stopping or rescheduling the
callout.
The callout subsystem acquires the associated lock before calling the
@@ -242,8 +244,7 @@
.Dv RM_SLEEPABLE
flag
.Pc
-may not be used with
-.Fn callout_init_rm .
+may not be used .
Similarly, other sleepable lock types such as
.Xr sx 9
and
@@ -254,10 +255,8 @@
These
.Fa flags
may be specified for
-.Fn callout_init_mtx ,
-.Fn callout_init_rm ,
-or
-.Fn callout_init_rw :
+.Fn callout_init_lock
+and associated compatibility macros.
.Bl -tag -width ".Dv CALLOUT_RETURNUNLOCKED"
.It Dv CALLOUT_RETURNUNLOCKED
The callout function will release the associated lock itself,
@@ -265,8 +264,8 @@
after the callout function returns.
.It Dv CALLOUT_SHAREDLOCK
The lock is only acquired in read mode when running the callout handler.
-This flag is ignored by
-.Fn callout_init_mtx .
+This flag is ignored if the lock is
+.Xr mutex 9 .
.El
.Pp
The function
@@ -585,10 +584,8 @@
.It
Callouts can be associated with a specific lock when they are initialized
by
-.Fn callout_init_mtx ,
-.Fn callout_init_rm ,
-or
-.Fn callout_init_rw .
+.Fn callout_init_lock
+or compatibility macros.
When a callout is associated with a lock,
the callout subsystem acquires the lock before the callout function is
invoked.
diff --git a/sys/sys/callout.h b/sys/sys/callout.h
--- a/sys/sys/callout.h
+++ b/sys/sys/callout.h
@@ -84,12 +84,14 @@
#define callout_drain(c) _callout_stop_safe(c, CS_DRAIN)
void callout_init(struct callout *, int);
void _callout_init_lock(struct callout *, struct lock_object *, int);
-#define callout_init_mtx(c, mtx, flags) \
- _callout_init_lock((c), &(mtx)->lock_object, (flags))
-#define callout_init_rm(c, rm, flags) \
- _callout_init_lock((c), &(rm)->lock_object, (flags))
-#define callout_init_rw(c, rw, flags) \
- _callout_init_lock((c), &(rw)->lock_object, (flags))
+#define callout_init_lock(c, lk, f) _Generic((lk), \
+ struct mtx *: _callout_init_lock((c), &(lk)->lock_object, (f)), \
+ struct mtx_padalign *: _callout_init_lock((c), &(lk)->lock_object, (f)),\
+ struct rmlock *: _callout_init_lock((c), &(lk)->lock_object, (f)), \
+ struct rwlock *: _callout_init_lock((c), &(lk)->lock_object, (f)))
+#define callout_init_mtx(c, mtx, flags) callout_init_lock((c), (mtx), (flags))
+#define callout_init_rm(c, rm, flags) callout_init_lock((c), (rm), (flags))
+#define callout_init_rw(c, rw, flags) callout_init_lock((c), (rw), (flags))
#define callout_pending(c) ((c)->c_iflags & CALLOUT_PENDING)
int callout_reset_sbt_on(struct callout *, sbintime_t, sbintime_t,
void (*)(void *), void *, int, int);

File Metadata

Mime Type
text/plain
Expires
Tue, Sep 8, 4:56 PM (4 h, 53 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
38499914
Default Alt Text
D59456.id186032.diff (4 KB)

Event Timeline