Debian Codegraph @

libsrc/os/unix/oss.c

raw
1 /*===========================================================================
2 Copyright (C) 1995-2009 European Southern Observatory (ESO)
3
4 This program is free software; you can redistribute it and/or
5 modify it under the terms of the GNU General Public License as
6 published by the Free Software Foundation; either version 2 of
7 the License, or (at your option) any later version.
8
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
13
14 You should have received a copy of the GNU General Public
15 License along with this program; if not, write to the Free
16 Software Foundation, Inc., 675 Massachusetss Ave, Cambridge,
17 MA 02139, USA.
18
19 Corresponding concerning ESO-MIDAS should be addressed as follows:
20 Internet e-mail: [email protected]
21 Postal address: European Southern Observatory
22 Data Management Division
23 Karl-Schwarzschild-Strasse 2
24 D 85748 Garching bei Muenchen
25 GERMANY
26 ===========================================================================*/
27
28 /*++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
29 .TYPE Module
30 .NAME oss
31 .LANGUAGE C
32 .AUTHOR IPG-ESO Garching
33 .CATEGORY Host operating system interfaces. Interprocess signals.
34 .COMMENTS These routines will handle the interprocess events and signals.
35 They will allow the following :
36 * to kill processes
37 * to send signals to other processes
38 * to catch or to ignore these signals
39 * to do something when a signal is caught
40 * to handle system interrupts like arithmetic traps and so ...
41 * to suspend and resume processes after some time.
42 * to wait for a signal (process synchronization).
43 .VERSION [0.0] 08-Dec-1986 Definition B. Pirenne
44 .VERSION [0.1] 09-Dec-1986 Programmation B. Pirenne
45 .VERSION [0.2] 30-Jan-1987 Allow more signals to be catched B. Pirenne
46 .VERSION [0.3] 30-Jan-1987 Add a time out in osswait B. Pirenne
47 .VERSION [1.0] 07-Jul-1987 Add SIGINT to the allowed signals B. Pirenne.
48 .VERSION [1.1] 05-May-1987 Cosmetic changes C. Guirao.
49 .VERSION [1.2] 25-Apr-1991 VOID + signal.
50 .VERSION [2.1] 14-Jul-1992 VOID is called now VOIDSIG
51 .VERSION [3.1] 21-Apr-1993 Posix compliant
52
53 090324 last modif
54 ------------------------------------------------------------*/
55 /*
56 * Define _POSIX_SOURCE to indicate
57 * that this is a POSIX program
58 */
59 #define _POSIX_SOURCE 1
60
61 #include <fcntl.h>
62 #include <stdio.h>
63 #include <signal.h>
64 #include <errno.h>
65 #include <unistd.h>
66 #include <proto_os.h> /* ANSI-C prototyping */
67
68 #ifdef OSERROR_D /* oserror already defined (Silicon G)*/
69 #define oserror midaserror
70 #endif
71
72 extern int oserror;
73 static int flag;
74
75 typedef void (*FUNCTION)(); /* Pointer to Function */
76
77 /* ARGSUSED */
78 #ifdef __STDC__
79 static void alarm_handler(int sig)
80 #else
81 static void alarm_handler(sig)
82 /*++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
83 .PURPOSE dummy routine to catch SIGALRM avoiding killing the process
84 -----------------------------------------------------------*/
85 int sig;
86 #endif
87 {
88 }
89
90 /* ARGSUSED */
91 #ifdef __STDC__
92 static void catch(int sig)
93 #else
94 static void catch(sig)
95 /*++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
96 .PURPOSE dummy routine to allow the pause call to return
97 .REMARKS ``sig'' is mandatory parameter always passed to a routine
98 called from osscatch.
99 .REMARKS sets the status variable to one if called.
100 ------------------------------------------------------------------*/
101 int sig;
102 #endif
103 {
104 flag = 0;
105 }
106
107
108 int osssend(pid, sig)
109 /*++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
110 .PURPOSE send a signal to a process
111 .RETURNS Upon successful completion a value of zero is returned, else 0
112 is returned and ``oserror'' is set to the actual error code.
113 .REMARKS System dependencies:
114 --UNIX: kill(2)
115 .REMARKS the allowed signals are only SIGUSR1,SIGUSR2,
116 SIGTERM and SIGALRM.
117 ------------------------------------------------------------*/
118 int pid; /* IN : process identification */
119 int sig; /* IN : signal (interruption) logical name */
120 {
121 switch (sig) {
122 case SIGKILL:
123 case SIGUSR1:
124 case SIGUSR2:
125 case SIGTERM:
126 case SIGALRM: /* allowed signals ... */
127 case SIGINT:
128 case SIGCHLD:
129 if(kill (pid,sig) < 0) {
130 oserror = errno;
131 return(-1);
132 }
133 break;
134 default: /* not allowed signals */;
135 oserror = EINVAL;
136 return(-1);
137 }
138 return(0);
139 }
140
141 int osscatch(sig, f)
142 /*++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
143 .PURPOSE Catch a signal and execute a given function when received.
144 .RETURNS Value 0 on normal return.
145 .REMARKS System dependencies:
146 --UNIX: sigaction()
147 .REMARKS This routine acts as a declarative statement : it means that
148 its effect continues until the end of the calling process or
149 until a new call to this routine for the same signal type.
150 It is then better located in the beginning of a program.
151 ------------------------------------------------------------*/
152 int sig; /* IN : signal identification (see signal.h) */
153 FUNCTION f; /* IN : Function to call in case of Interrupt */
154 {
155 struct sigaction act, oact;
156
157 act.sa_handler = f;
158 sigemptyset(&act.sa_mask);
159 act.sa_flags = 0;
160 if (sigaction(sig,&act,&oact) != 0) { oserror = errno; return(-1); };
161
162 return(0);
163 }
164
165
166 int osswait(sig,time_out)
167 /*++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
168 .PURPOSE Waits for signal to be received.
169 .RETURNS Value -1 if something wrong happened, 0 is a signal has been
170 received before the timeout, 1 if stopped for time out .
171 .REMARKS System dependencies:
172 --UNIX: sigaction(2), pause(2), sleep(3)
173 .REMARKS This routine acts as an executable statement : it means that
174 its effect will be to wait for the given signal (!! One can only
175 wait for a signal that it is possible to send (INT, ALRM, TERM, USR1
176 or USR2). The execution
177 of the calling process will be interrupted during this wait
178 time. The execution will continue if the given signal is received
179 or if the time out period is expired.
180 This routine is best used with ``osssend'' to suspend and resume
181 programmes execution.
182 .REMARKS It could have been implemented with sleep(). With Posix sleep should
183 have returned when any signal is received, but not with BSD systems
184 (SunOS) where sleep elapsed the time even when signals are received
185 ------------------------------------------------------------*/
186 int sig; /* IN : signal identification (see signal.h) */
187 unsigned time_out; /* IN : amount of seconds allowed for the */
188 /* wait (0 = infinite) */
189 {
190 struct sigaction act, oact, oalrm;
191 sigset_t set;
192
193 flag=1;
194 /* check the value of the signal to wait for ... */
195 switch (sig) {
196 case SIGUSR1:
197 case SIGUSR2:
198 case SIGTERM:
199 case SIGALRM:
200 case SIGINT:
201 case SIGCHLD:
202
203 /* Catch the signal ALRM to avoid proccess to terminate */
204 act.sa_handler = alarm_handler;
205 sigemptyset(&act.sa_mask);
206 act.sa_flags = 0;
207 if (sigaction(SIGALRM,&act,&oalrm) != 0) { oserror = errno; return(-1); }
208
209 /* Catch the signal sig to change value of flag */
210 act.sa_handler = catch;
211 if (sigaction(sig,&act,&oact) != 0) { oserror = errno; return(-1); }
212
213 /* Suspend process all signal except sig & SIGALRM (for a */
214 sigfillset(&set);
215 sigdelset(&set,sig);
216 sigdelset(&set,SIGALRM);
217
218 /* Set alarm if timeout */
219 if (time_out != 0) (void) alarm(time_out);
220
221 /* wait for signal to come or timeout */
222 (void) sigsuspend(&set);
223
224 /* If timeout cancel alarm */
225 if (time_out != 0) (void) alarm(0);
226
227 /* restore previous status for sig and SIGALRM */
228 if (sigaction(sig,&oact,&act) != 0) { oserror = errno; return(-1); }
229 if (sigaction(sig,&oalrm,&act) != 0) { oserror = errno; return(-1); }
230 return(flag); /* flag=0 (signal arrived), 1 (timeout first) */
231 default:
232 oserror = EINVAL;
233 return(-1);
234 }
235 }