MINOR: stream-int: make it clear that si_ops cannot be null
There was an ambiguity in which functions of the si_ops struct could be
null or not. only ->update doesn't exist in one of the si_ops (the
embedded one), all others are always defined. ->shutr and ->shutw were
never tested. However ->chk_rcv() and ->chk_snd() were tested, causing
confusion about the proper way to wake the other side up if undefined
(which never happens).
Let's update the comments to state these functions are mandatory and
remove the offending checks.
diff --git a/include/types/stream_interface.h b/include/types/stream_interface.h
index 3a9895e..0362afd 100644
--- a/include/types/stream_interface.h
+++ b/include/types/stream_interface.h
@@ -106,11 +106,11 @@
/* operations available on a stream-interface */
struct si_ops {
- void (*update)(struct stream_interface *); /* I/O update function */
- void (*chk_rcv)(struct stream_interface *); /* chk_rcv function */
- void (*chk_snd)(struct stream_interface *); /* chk_snd function */
- void (*shutr)(struct stream_interface *); /* shut read function */
- void (*shutw)(struct stream_interface *); /* shut write function */
+ void (*update)(struct stream_interface *); /* I/O update function, may be null */
+ void (*chk_rcv)(struct stream_interface *); /* chk_rcv function, may not be null */
+ void (*chk_snd)(struct stream_interface *); /* chk_snd function, may not be null */
+ void (*shutr)(struct stream_interface *); /* shut read function, may not be null */
+ void (*shutw)(struct stream_interface *); /* shut write function, may not be null */
};
#endif /* _TYPES_STREAM_INTERFACE_H */