(strsignal): Count real-time signals from zero.
[kopensolaris-gnu/glibc.git] / string / strsignal.c
1 /* Copyright (C) 1991, 94, 95, 96, 97, 98 Free Software Foundation, Inc.
2    This file is part of the GNU C Library.
3
4    The GNU C Library is free software; you can redistribute it and/or
5    modify it under the terms of the GNU Library General Public License as
6    published by the Free Software Foundation; either version 2 of the
7    License, or (at your option) any later version.
8
9    The GNU C Library 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 GNU
12    Library General Public License for more details.
13
14    You should have received a copy of the GNU Library General Public
15    License along with the GNU C Library; see the file COPYING.LIB.  If not,
16    write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17    Boston, MA 02111-1307, USA.  */
18
19 #include <signal.h>
20 #include <stdio.h>
21 #include <stdlib.h>
22 #include <string.h>
23 #include <bits/libc-lock.h>
24
25
26 #ifndef HAVE_GNU_LD
27 #define _sys_siglist    sys_siglist
28 #endif
29
30 /* Defined in siglist.c.  */
31 extern const char *const _sys_siglist[];
32 static __libc_key_t key;
33
34 /* If nonzero the key allocation failed and we should better use a
35    static buffer than fail.  */
36 #define BUFFERSIZ       100
37 static char local_buf[BUFFERSIZ];
38 static char *static_buf;
39
40 /* Destructor for the thread-specific data.  */
41 static void init (void);
42 static void free_key_mem (void *mem);
43 static char *getbuffer (void);
44
45
46 /* Return a string describing the meaning of the signal number SIGNUM.  */
47 char *
48 strsignal (int signum)
49 {
50   __libc_once_define (static, once);
51   const char *desc;
52
53   /* If we have not yet initialized the buffer do it now.  */
54   __libc_once (once, init);
55
56   if (
57 #ifdef SIGRTMIN
58       (signum >= SIGRTMIN && signum <= SIGRTMAX) ||
59 #endif
60       signum < 0 || signum >= NSIG || (desc = _sys_siglist[signum]) == NULL)
61     {
62       char *buffer = getbuffer ();
63       int len;
64 #ifdef SIGRTMIN
65       if (signum >= SIGRTMIN && signum <= SIGRTMAX)
66         len = __snprintf (buffer, BUFFERSIZ - 1, _("Real-time signal %d"),
67                           signum - SIGRTMIN);
68       else
69 #endif
70         len = __snprintf (buffer, BUFFERSIZ - 1, _("Unknown signal %d"),
71                           signum);
72       if (len < 0)
73         buffer = NULL;
74       else
75         buffer[len] = '\0';
76
77       return buffer;
78     }
79
80   return (char *) _(desc);
81 }
82
83
84 /* Initialize buffer.  */
85 static void
86 init (void)
87 {
88   if (__libc_key_create (&key, free_key_mem))
89     /* Creating the key failed.  This means something really went
90        wrong.  In any case use a static buffer which is better than
91        nothing.  */
92     static_buf = local_buf;
93 }
94
95
96 /* Free the thread specific data, this is done if a thread terminates.  */
97 static void
98 free_key_mem (void *mem)
99 {
100   free (mem);
101   __libc_setspecific (key, NULL);
102 }
103
104
105 /* Return the buffer to be used.  */
106 static char *
107 getbuffer (void)
108 {
109   char *result;
110
111   if (static_buf != NULL)
112     result = static_buf;
113   else
114     {
115       /* We don't use the static buffer and so we have a key.  Use it
116          to get the thread-specific buffer.  */
117       result = __libc_getspecific (key);
118       if (result == NULL)
119         {
120           /* No buffer allocated so far.  */
121           result = malloc (BUFFERSIZ);
122           if (result == NULL)
123             /* No more memory available.  We use the static buffer.  */
124             result = local_buf;
125           else
126             __libc_setspecific (key, result);
127         }
128     }
129
130   return result;
131 }