calls: Update params in rt_sigaction()

XuShaohua · Jul 30, 2024 · 0b111ca · 0b111ca
1 parent b13ac6b
commit 0b111ca
Show file tree

Hide file tree

Showing 21 changed files with 150 additions and 221 deletions.
diff --git a/examples/alarm.rs b/examples/alarm.rs
@@ -18,8 +18,7 @@ fn main() {
         ..nc::sigaction_t::default()
     };
     println!("sa size: {}", size_of_val(&sa));
-    let mut old_sa = nc::sigaction_t::default();
-    let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+    let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
     assert!(ret.is_ok());
 
     let seconds = 1;

diff --git a/examples/mprotect.rs b/examples/mprotect.rs
@@ -2,8 +2,6 @@
 // Use of this source is governed by Apache-2.0 License that can be found
 // in the LICENSE file.
 
-use std::mem;
-
 fn handle_segfault(sig: i32) {
     println!("Got segfault");
     assert_eq!(sig, nc::SIGSEGV);
@@ -16,15 +14,7 @@ fn main() {
         sa_flags: nc::SA_SIGINFO,
         ..nc::sigaction_t::default()
     };
-    let mut old_sa = nc::sigaction_t::default();
-    let ret = unsafe {
-        nc::rt_sigaction(
-            nc::SIGSEGV,
-            &sa,
-            &mut old_sa,
-            mem::size_of::<nc::sigset_t>(),
-        )
-    };
+    let ret = unsafe { nc::rt_sigaction(nc::SIGSEGV, &sa, None) };
     assert!(ret.is_ok());
 
     // Initialize an anonymous mapping with 4 pages.

diff --git a/examples/timer.rs b/examples/timer.rs
@@ -12,8 +12,7 @@ fn main() {
         sa_flags: 0,
         ..nc::sigaction_t::default()
     };
-    let mut old_sa = nc::sigaction_t::default();
-    let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+    let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
     assert!(ret.is_ok());
 
     // Single shot timer, actived after 1 second.

diff --git a/src/calls/alarm.rs b/src/calls/alarm.rs
@@ -13,8 +13,7 @@
 ///     sa_handler: handle_alarm as nc::sighandler_t,
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
 /// assert!(ret.is_ok());
 /// let remaining = unsafe { nc::alarm(1) };
 /// let mask = nc::sigset_t::default();

diff --git a/src/calls/getitimer.rs b/src/calls/getitimer.rs
@@ -17,8 +17,7 @@
 ///     sa_flags: 0,
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
 /// assert!(ret.is_ok());
 ///
 /// // Single shot timer, actived after 1 second.

diff --git a/src/calls/pause.rs b/src/calls/pause.rs
@@ -13,8 +13,7 @@
 ///     sa_handler: handle_alarm as nc::sighandler_t,
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
 /// assert!(ret.is_ok());
 /// let remaining = unsafe { nc::alarm(1) };
 /// let ret = unsafe { nc::pause() };

diff --git a/src/calls/rt_sigaction.rs b/src/calls/rt_sigaction.rs
@@ -14,19 +14,20 @@
 ///     sa_mask: (nc::SA_RESTART | nc::SA_SIGINFO | nc::SA_ONSTACK).into(),
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGTERM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGTERM, &sa, None) };
 /// let ret = unsafe { nc::kill(nc::getpid(), nc::SIGTERM) };
 /// assert!(ret.is_ok());
 /// ```
 pub unsafe fn rt_sigaction(
     sig: i32,
     act: &sigaction_t,
-    old_act: &mut sigaction_t,
-    sigsetsize: size_t,
+    old_act: Option<&mut sigaction_t>,
 ) -> Result<(), Errno> {
     let sig = sig as usize;
     let act_ptr = act as *const sigaction_t as usize;
-    let old_act_ptr = old_act as *mut sigaction_t as usize;
-    syscall4(SYS_RT_SIGACTION, sig, act_ptr, old_act_ptr, sigsetsize).map(drop)
+    let old_act_ptr = old_act.map_or(core::ptr::null_mut::<sigaction_t>() as usize, |old_act| {
+        old_act as *mut sigaction_t as usize
+    });
+    let sigset_size = core::mem::size_of::<sigset_t>();
+    syscall4(SYS_RT_SIGACTION, sig, act_ptr, old_act_ptr, sigset_size).map(drop)
 }
diff --git a/src/calls/setitimer.rs b/src/calls/setitimer.rs
@@ -17,8 +17,7 @@
 ///     sa_flags: 0,
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
 /// assert!(ret.is_ok());
 ///
 /// // Single shot timer, actived after 1 second.

diff --git a/src/calls/timer_getoverrun.rs b/src/calls/timer_getoverrun.rs
@@ -17,8 +17,7 @@
 ///         sa_handler: handle_alarm as nc::sighandler_t,
 ///         ..nc::sigaction_t::default()
 ///     };
-///     let mut old_sa = nc::sigaction_t::default();
-///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, None) };
 ///     assert!(ret.is_ok());
 ///
 ///     let tid = nc::itimerspec_t {

diff --git a/src/calls/timer_gettime.rs b/src/calls/timer_gettime.rs
@@ -17,8 +17,7 @@
 ///         sa_handler: handle_alarm as nc::sighandler_t,
 ///         ..nc::sigaction_t::default()
 ///     };
-///     let mut old_sa = nc::sigaction_t::default();
-///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, None) };
 ///     assert!(ret.is_ok());
 ///
 ///     let tid = nc::itimerspec_t {

diff --git a/src/calls/timer_settime.rs b/src/calls/timer_settime.rs
@@ -17,8 +17,7 @@
 ///         sa_handler: handle_alarm as nc::sighandler_t,
 ///         ..nc::sigaction_t::default()
 ///     };
-///     let mut old_sa = nc::sigaction_t::default();
-///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, None) };
 ///     assert!(ret.is_ok());
 ///
 ///     let tid = nc::itimerspec_t {

diff --git a/src/platform/linux-aarch64/call.rs b/src/platform/linux-aarch64/call.rs
@@ -1831,8 +1831,7 @@ pub unsafe fn getgroups(size: i32, group_list: &mut [gid_t]) -> Result<i32, Errn
 ///     sa_flags: 0,
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
 /// assert!(ret.is_ok());
 ///
 /// // Single shot timer, actived after 1 second.
@@ -5032,21 +5031,22 @@ pub unsafe fn rseq(rseq: &mut [rseq_t], flags: i32, sig: u32) -> Result<i32, Err
 ///     sa_mask: (nc::SA_RESTART | nc::SA_SIGINFO | nc::SA_ONSTACK).into(),
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGTERM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGTERM, &sa, None) };
 /// let ret = unsafe { nc::kill(nc::getpid(), nc::SIGTERM) };
 /// assert!(ret.is_ok());
 /// ```
 pub unsafe fn rt_sigaction(
     sig: i32,
     act: &sigaction_t,
-    old_act: &mut sigaction_t,
-    sigsetsize: size_t,
+    old_act: Option<&mut sigaction_t>,
 ) -> Result<(), Errno> {
     let sig = sig as usize;
     let act_ptr = act as *const sigaction_t as usize;
-    let old_act_ptr = old_act as *mut sigaction_t as usize;
-    syscall4(SYS_RT_SIGACTION, sig, act_ptr, old_act_ptr, sigsetsize).map(drop)
+    let old_act_ptr = old_act.map_or(core::ptr::null_mut::<sigaction_t>() as usize, |old_act| {
+        old_act as *mut sigaction_t as usize
+    });
+    let sigset_size = core::mem::size_of::<sigset_t>();
+    syscall4(SYS_RT_SIGACTION, sig, act_ptr, old_act_ptr, sigset_size).map(drop)
 }
 
 /// Examine pending signals.
@@ -5702,8 +5702,7 @@ pub unsafe fn sethostname<P: AsRef<Path>>(name: P) -> Result<(), Errno> {
 ///     sa_flags: 0,
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
 /// assert!(ret.is_ok());
 ///
 /// // Single shot timer, actived after 1 second.
@@ -6665,8 +6664,7 @@ pub unsafe fn timer_delete(timer_id: timer_t) -> Result<(), Errno> {
 ///         sa_handler: handle_alarm as nc::sighandler_t,
 ///         ..nc::sigaction_t::default()
 ///     };
-///     let mut old_sa = nc::sigaction_t::default();
-///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, None) };
 ///     assert!(ret.is_ok());
 ///
 ///     let tid = nc::itimerspec_t {
@@ -6740,8 +6738,7 @@ pub unsafe fn timer_getoverrun(timer_id: timer_t) -> Result<i32, Errno> {
 ///         sa_handler: handle_alarm as nc::sighandler_t,
 ///         ..nc::sigaction_t::default()
 ///     };
-///     let mut old_sa = nc::sigaction_t::default();
-///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, None) };
 ///     assert!(ret.is_ok());
 ///
 ///     let tid = nc::itimerspec_t {
@@ -6812,8 +6809,7 @@ pub unsafe fn timer_gettime(timer_id: timer_t, curr: &mut itimerspec_t) -> Resul
 ///         sa_handler: handle_alarm as nc::sighandler_t,
 ///         ..nc::sigaction_t::default()
 ///     };
-///     let mut old_sa = nc::sigaction_t::default();
-///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, None) };
 ///     assert!(ret.is_ok());
 ///
 ///     let tid = nc::itimerspec_t {

diff --git a/src/platform/linux-arm/call.rs b/src/platform/linux-arm/call.rs
@@ -2222,8 +2222,7 @@ pub unsafe fn getgroups(size: i32, group_list: &mut [gid_t]) -> Result<i32, Errn
 ///     sa_flags: 0,
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
 /// assert!(ret.is_ok());
 ///
 /// // Single shot timer, actived after 1 second.
@@ -4598,8 +4597,7 @@ pub unsafe fn open_tree<P: AsRef<Path>>(dfd: i32, filename: P, flags: u32) -> Re
 ///     sa_handler: handle_alarm as nc::sighandler_t,
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
 /// assert!(ret.is_ok());
 /// let remaining = unsafe { nc::alarm(1) };
 /// let ret = unsafe { nc::pause() };
@@ -5816,21 +5814,22 @@ pub unsafe fn rseq(rseq: &mut [rseq_t], flags: i32, sig: u32) -> Result<i32, Err
 ///     sa_mask: (nc::SA_RESTART | nc::SA_SIGINFO | nc::SA_ONSTACK).into(),
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGTERM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGTERM, &sa, None) };
 /// let ret = unsafe { nc::kill(nc::getpid(), nc::SIGTERM) };
 /// assert!(ret.is_ok());
 /// ```
 pub unsafe fn rt_sigaction(
     sig: i32,
     act: &sigaction_t,
-    old_act: &mut sigaction_t,
-    sigsetsize: size_t,
+    old_act: Option<&mut sigaction_t>,
 ) -> Result<(), Errno> {
     let sig = sig as usize;
     let act_ptr = act as *const sigaction_t as usize;
-    let old_act_ptr = old_act as *mut sigaction_t as usize;
-    syscall4(SYS_RT_SIGACTION, sig, act_ptr, old_act_ptr, sigsetsize).map(drop)
+    let old_act_ptr = old_act.map_or(core::ptr::null_mut::<sigaction_t>() as usize, |old_act| {
+        old_act as *mut sigaction_t as usize
+    });
+    let sigset_size = core::mem::size_of::<sigset_t>();
+    syscall4(SYS_RT_SIGACTION, sig, act_ptr, old_act_ptr, sigset_size).map(drop)
 }
 
 /// Examine pending signals.
@@ -6507,8 +6506,7 @@ pub unsafe fn sethostname<P: AsRef<Path>>(name: P) -> Result<(), Errno> {
 ///     sa_flags: 0,
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
 /// assert!(ret.is_ok());
 ///
 /// // Single shot timer, actived after 1 second.
@@ -7583,8 +7581,7 @@ pub unsafe fn timer_delete(timer_id: timer_t) -> Result<(), Errno> {
 ///         sa_handler: handle_alarm as nc::sighandler_t,
 ///         ..nc::sigaction_t::default()
 ///     };
-///     let mut old_sa = nc::sigaction_t::default();
-///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, None) };
 ///     assert!(ret.is_ok());
 ///
 ///     let tid = nc::itimerspec_t {
@@ -7658,8 +7655,7 @@ pub unsafe fn timer_getoverrun(timer_id: timer_t) -> Result<i32, Errno> {
 ///         sa_handler: handle_alarm as nc::sighandler_t,
 ///         ..nc::sigaction_t::default()
 ///     };
-///     let mut old_sa = nc::sigaction_t::default();
-///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, None) };
 ///     assert!(ret.is_ok());
 ///
 ///     let tid = nc::itimerspec_t {
@@ -7730,8 +7726,7 @@ pub unsafe fn timer_gettime(timer_id: timer_t, curr: &mut itimerspec_t) -> Resul
 ///         sa_handler: handle_alarm as nc::sighandler_t,
 ///         ..nc::sigaction_t::default()
 ///     };
-///     let mut old_sa = nc::sigaction_t::default();
-///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, None) };
 ///     assert!(ret.is_ok());
 ///
 ///     let tid = nc::itimerspec_t {

diff --git a/src/platform/linux-loongarch64/call.rs b/src/platform/linux-loongarch64/call.rs
@@ -1539,8 +1539,7 @@ pub unsafe fn getgroups(size: i32, group_list: &mut [gid_t]) -> Result<i32, Errn
 ///     sa_flags: 0,
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
 /// assert!(ret.is_ok());
 ///
 /// // Single shot timer, actived after 1 second.
@@ -4364,21 +4363,22 @@ pub unsafe fn rseq(rseq: &mut [rseq_t], flags: i32, sig: u32) -> Result<i32, Err
 ///     sa_mask: (nc::SA_RESTART | nc::SA_SIGINFO | nc::SA_ONSTACK).into(),
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGTERM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGTERM, &sa, None) };
 /// let ret = unsafe { nc::kill(nc::getpid(), nc::SIGTERM) };
 /// assert!(ret.is_ok());
 /// ```
 pub unsafe fn rt_sigaction(
     sig: i32,
     act: &sigaction_t,
-    old_act: &mut sigaction_t,
-    sigsetsize: size_t,
+    old_act: Option<&mut sigaction_t>,
 ) -> Result<(), Errno> {
     let sig = sig as usize;
     let act_ptr = act as *const sigaction_t as usize;
-    let old_act_ptr = old_act as *mut sigaction_t as usize;
-    syscall4(SYS_RT_SIGACTION, sig, act_ptr, old_act_ptr, sigsetsize).map(drop)
+    let old_act_ptr = old_act.map_or(core::ptr::null_mut::<sigaction_t>() as usize, |old_act| {
+        old_act as *mut sigaction_t as usize
+    });
+    let sigset_size = core::mem::size_of::<sigset_t>();
+    syscall4(SYS_RT_SIGACTION, sig, act_ptr, old_act_ptr, sigset_size).map(drop)
 }
 
 /// Examine pending signals.
@@ -5034,8 +5034,7 @@ pub unsafe fn sethostname<P: AsRef<Path>>(name: P) -> Result<(), Errno> {
 ///     sa_flags: 0,
 ///     ..nc::sigaction_t::default()
 /// };
-/// let mut old_sa = nc::sigaction_t::default();
-/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+/// let ret = unsafe { nc::rt_sigaction(nc::SIGALRM, &sa, None) };
 /// assert!(ret.is_ok());
 ///
 /// // Single shot timer, actived after 1 second.
@@ -5976,8 +5975,7 @@ pub unsafe fn timer_delete(timer_id: timer_t) -> Result<(), Errno> {
 ///         sa_handler: handle_alarm as nc::sighandler_t,
 ///         ..nc::sigaction_t::default()
 ///     };
-///     let mut old_sa = nc::sigaction_t::default();
-///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, None) };
 ///     assert!(ret.is_ok());
 ///
 ///     let tid = nc::itimerspec_t {
@@ -6051,8 +6049,7 @@ pub unsafe fn timer_getoverrun(timer_id: timer_t) -> Result<i32, Errno> {
 ///         sa_handler: handle_alarm as nc::sighandler_t,
 ///         ..nc::sigaction_t::default()
 ///     };
-///     let mut old_sa = nc::sigaction_t::default();
-///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, None) };
 ///     assert!(ret.is_ok());
 ///
 ///     let tid = nc::itimerspec_t {
@@ -6123,8 +6120,7 @@ pub unsafe fn timer_gettime(timer_id: timer_t, curr: &mut itimerspec_t) -> Resul
 ///         sa_handler: handle_alarm as nc::sighandler_t,
 ///         ..nc::sigaction_t::default()
 ///     };
-///     let mut old_sa = nc::sigaction_t::default();
-///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, &mut old_sa, size_of::<nc::sigset_t>()) };
+///     let ret = unsafe { nc::rt_sigaction(TIMER_SIG, &sa, None) };
 ///     assert!(ret.is_ok());
 ///
 ///     let tid = nc::itimerspec_t {