From mboxrd@z Thu Jan 1 00:00:00 1970 From: Cyrill Gorcunov Subject: [patch 4/4] timerfd.2: Add ioctl method description Date: Wed, 16 Jul 2014 01:54:55 +0400 Message-ID: <20140715215703.353177995@openvz.org> References: <20140715215451.499191426@openvz.org> Return-path: Content-Disposition: inline; filename=timerfd-man Sender: linux-kernel-owner@vger.kernel.org To: linux-kernel@vger.kernel.org, linux-api@vger.kernel.org Cc: Michael Kerrisk , Thomas Gleixner , Cyrill Gorcunov , Andrew Morton , Andrey Vagin , Pavel Emelyanov , Vladimir Davydov List-Id: linux-api@vger.kernel.org ioctl(2) The following commands are supported: TFD_IOC_SET_TICKS to adjust the number of the timer expirations that have occurred. It take a pointer to nonzero 8-byte integer (uint64_t*) containing new number of expirations. Once the number is set any waiter on the timer is woken up. The only purpose of this command is to restore the expirations in a sake of checkpoint/restore procedure. It requires the kernel to be built with CONFIG_CHECKPOINT_RESTORE support. Signed-off-by: Cyrill Gorcunov CC: Michael Kerrisk CC: Thomas Gleixner CC: Andrew Morton CC: Andrey Vagin CC: Pavel Emelyanov CC: Vladimir Davydov CC: linux-api@vger.kernel.org --- man2/timerfd_create.2 | 14 ++++++++++++++ 1 file changed, 14 insertions(+) Index: man-pages/man2/timerfd_create.2 =================================================================== --- man-pages.orig/man2/timerfd_create.2 +++ man-pages/man2/timerfd_create.2 @@ -260,6 +260,20 @@ multiplexing APIs: and .BR epoll (7). .TP +.BR ioctl "(2)" +The following commands are supported: +.B TFD_IOC_SET_TICKS +to adjust the number of the timer expirations that have occurred. +It take a pointer to nonzero 8-byte integer +.RI ( uint64_t *) +containing the new number of expirations. +Once the number is set any waiter on the timer is woken up. +The only purpose of this command is to restore the expirations +in a sake of checkpoint/restore procedure. +It requires the kernel to be built with +.BR CONFIG_CHECKPOINT_RESTORE +support. +.TP .BR close (2) When the file descriptor is no longer required it should be closed. When all file descriptors associated with the same timer object