166492cf0SYuri Pankov.\" 266492cf0SYuri Pankov.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for 366492cf0SYuri Pankov.\" permission to reproduce portions of its copyrighted documentation. 466492cf0SYuri Pankov.\" Original documentation from The Open Group can be obtained online at 5c10c16deSRichard Lowe.\" http://www.opengroup.org/bookstore/. 666492cf0SYuri Pankov.\" 766492cf0SYuri Pankov.\" The Institute of Electrical and Electronics Engineers and The Open 866492cf0SYuri Pankov.\" Group, have given us permission to reprint portions of their 966492cf0SYuri Pankov.\" documentation. 1066492cf0SYuri Pankov.\" 1166492cf0SYuri Pankov.\" In the following statement, the phrase ``this text'' refers to portions 1266492cf0SYuri Pankov.\" of the system documentation. 1366492cf0SYuri Pankov.\" 1466492cf0SYuri Pankov.\" Portions of this text are reprinted and reproduced in electronic form 1566492cf0SYuri Pankov.\" in the SunOS Reference Manual, from IEEE Std 1003.1, 2004 Edition, 1666492cf0SYuri Pankov.\" Standard for Information Technology -- Portable Operating System 1766492cf0SYuri Pankov.\" Interface (POSIX), The Open Group Base Specifications Issue 6, 1866492cf0SYuri Pankov.\" Copyright (C) 2001-2004 by the Institute of Electrical and Electronics 1966492cf0SYuri Pankov.\" Engineers, Inc and The Open Group. In the event of any discrepancy 2066492cf0SYuri Pankov.\" between these versions and the original IEEE and The Open Group 2166492cf0SYuri Pankov.\" Standard, the original IEEE and The Open Group Standard is the referee 2266492cf0SYuri Pankov.\" document. The original Standard can be obtained online at 2366492cf0SYuri Pankov.\" http://www.opengroup.org/unix/online.html. 2466492cf0SYuri Pankov.\" 25c10c16deSRichard Lowe.\" This notice shall appear on any product containing this material. 2666492cf0SYuri Pankov.\" 2766492cf0SYuri Pankov.\" The Berkeley software License Agreement specifies the terms and conditions 2866492cf0SYuri Pankov.\" for redistribution. 2966492cf0SYuri Pankov.\" 3066492cf0SYuri Pankov.\" 3166492cf0SYuri Pankov.\" Copyright (c) 1980 Regents of the University of California. 3266492cf0SYuri Pankov.\" All rights reserved. 3366492cf0SYuri Pankov.\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved 3466492cf0SYuri Pankov.\" Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved. 3566492cf0SYuri Pankov.\" Copyright 2014 Garrett D'Amore <garrett@damore.org> 3666492cf0SYuri Pankov.\" 3708eb1913SGarrett D'Amore.Dd "Aug 16, 2014" 3808eb1913SGarrett D'Amore.Dt UALARM 3C 3908eb1913SGarrett D'Amore.Os 4008eb1913SGarrett D'Amore.Sh NAME 4108eb1913SGarrett D'Amore.Nm ualarm 4208eb1913SGarrett D'Amore.Nd schedule signal after interval in microseconds 4308eb1913SGarrett D'Amore.Sh SYNOPSIS 4408eb1913SGarrett D'Amore.In unistd.h 4508eb1913SGarrett D'Amore.Ft useconds_t 4608eb1913SGarrett D'Amore.Fn ualarm "useconds_t useconds" "useconds_t interval" 4708eb1913SGarrett D'Amore.Sh DESCRIPTION 4808eb1913SGarrett D'AmoreThe 4908eb1913SGarrett D'Amore.Fn ualarm 5008eb1913SGarrett D'Amorefunction causes the 5108eb1913SGarrett D'Amore.Dv SIGALRM 5208eb1913SGarrett D'Amoresignal to be generated for 53c10c16deSRichard Lowethe calling process after the number of real-time microseconds specified by the 5408eb1913SGarrett D'Amore.Fa useconds 5572d3dbb9SYuri Pankovargument has elapsed. 5672d3dbb9SYuri PankovWhen the 5708eb1913SGarrett D'Amore.Fa interval 5808eb1913SGarrett D'Amoreargument is 59c10c16deSRichard Lowenon-zero, repeated timeout notification occurs with a period in microseconds 6072d3dbb9SYuri Pankovspecified by the 6172d3dbb9SYuri Pankov.Fa interval 6272d3dbb9SYuri Pankovargument. 6372d3dbb9SYuri PankovIf the notification signal, 6408eb1913SGarrett D'Amore.Dv SIGALRM , 6508eb1913SGarrett D'Amoreis not caught or ignored, the calling process is terminated. 6608eb1913SGarrett D'Amore.Lp 67c10c16deSRichard LoweBecause of scheduling delays, resumption of execution when the signal is caught 68c10c16deSRichard Lowemay be delayed an arbitrary amount of time. 6908eb1913SGarrett D'Amore.Lp 7008eb1913SGarrett D'AmoreInteractions between 7108eb1913SGarrett D'Amore.Fn ualarm 7208eb1913SGarrett D'Amoreand either 7308eb1913SGarrett D'Amore.Xr alarm 2 7408eb1913SGarrett D'Amoreor 7508eb1913SGarrett D'Amore.Xr sleep 3C 7608eb1913SGarrett D'Amoreare unspecified. 7708eb1913SGarrett D'Amore.Sh RETURN VALUES 7808eb1913SGarrett D'AmoreThe 7908eb1913SGarrett D'Amore.Fn ualarm 8008eb1913SGarrett D'Amorefunction returns the number of microseconds remaining from 8108eb1913SGarrett D'Amorethe previous 8208eb1913SGarrett D'Amore.Fn ualarm 8372d3dbb9SYuri Pankovcall. 8472d3dbb9SYuri PankovIf no timeouts are pending or if 8508eb1913SGarrett D'Amore.Fn ualarm 8608eb1913SGarrett D'Amorehas not previously been called, 8708eb1913SGarrett D'Amore.Fn ualarm 8808eb1913SGarrett D'Amorereturns 0. 8908eb1913SGarrett D'Amore.Sh ERRORS 90c10c16deSRichard LoweNo errors are defined. 9108eb1913SGarrett D'Amore.Sh USAGE 9208eb1913SGarrett D'AmoreThe 9308eb1913SGarrett D'Amore.Fn ualarm 9408eb1913SGarrett D'Amorefunction is a simplified interface to 9508eb1913SGarrett D'Amore.Xr setitimer 2 , 9608eb1913SGarrett D'Amoreand uses the 9708eb1913SGarrett D'Amore.Dv ITIMER_REAL 9872d3dbb9SYuri Pankovinterval timer. 9972d3dbb9SYuri PankovIt's use has been deprecated in favor of the 10008eb1913SGarrett D'Amore.Xr timer_create 3C 10108eb1913SGarrett D'Amorefamily of functions. 10208eb1913SGarrett D'Amore.Sh INTERFACE STABILITY 10308eb1913SGarrett D'Amore.Sy Obsolete Standard . 10408eb1913SGarrett D'Amore.Sh SEE ALSO 10508eb1913SGarrett D'Amore.Xr alarm 2 , 10608eb1913SGarrett D'Amore.Xr setitimer 2 , 10708eb1913SGarrett D'Amore.Xr sighold 3C , 10808eb1913SGarrett D'Amore.Xr signal 3C , 10908eb1913SGarrett D'Amore.Xr sleep 3C , 11008eb1913SGarrett D'Amore.Xr timer_create 3C , 11108eb1913SGarrett D'Amore.Xr usleep 3C , 11208eb1913SGarrett D'Amore.Xr unistd.h 3HEAD , 113*bbf21555SRichard Lowe.Xr standards 7 11408eb1913SGarrett D'Amore.Sh STANDARDS 11508eb1913SGarrett D'AmoreThe 11608eb1913SGarrett D'Amore.Fn ualarm 11772d3dbb9SYuri Pankovfunction is available in the following compilation environments. 11872d3dbb9SYuri PankovSee 119*bbf21555SRichard Lowe.Xr standards 7 . 12008eb1913SGarrett D'Amore.Lp 12108eb1913SGarrett D'Amore.Bl -bullet -compact 12208eb1913SGarrett D'Amore.\".It 12308eb1913SGarrett D'Amore.\".St -p1003.1-90 12408eb1913SGarrett D'Amore.\".It 12508eb1913SGarrett D'Amore.\".St -p1003.1b-93 12608eb1913SGarrett D'Amore.\".It 12708eb1913SGarrett D'Amore.\".St -p1003.1c-95 12808eb1913SGarrett D'Amore.\".It 12908eb1913SGarrett D'Amore.\".St -p1003.1-2001 13008eb1913SGarrett D'Amore.\".It 13108eb1913SGarrett D'Amore.\".St -xpg3 13208eb1913SGarrett D'Amore.\".It 13308eb1913SGarrett D'Amore.\".St -xpg4 13408eb1913SGarrett D'Amore.It 13508eb1913SGarrett D'Amore.St -xpg4.2 13608eb1913SGarrett D'Amore.It 13708eb1913SGarrett D'Amore.St -susv2 13808eb1913SGarrett D'Amore.It 13908eb1913SGarrett D'Amore.St -susv3 14008eb1913SGarrett D'Amore.El 14108eb1913SGarrett D'Amore.Lp 14208eb1913SGarrett D'AmoreIt is marked obsolete in 14308eb1913SGarrett D'Amore.St -susv3 , and was removed from 14408eb1913SGarrett D'Amore.St -p1003.1-2008 . 145