chiark / gitweb /
@@ -1,6 +1,7 @@
[userv.git] / lib.h
1 /*
2  * userv - lib.c
3  * useful utility routines' imports and exports, used in daemon
4  *
5  * Copyright (C)1996-1997,1999 Ian Jackson
6  *
7  * This is free software; you can redistribute it and/or modify it
8  * under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful, but
13  * WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with userv; if not, write to the Free Software
19  * Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
20  */
21
22 #ifndef LIB_H
23 #define LIB_H
24
25 char *xstrcat3save(const char *a, const char *b, const char *c);
26 char *xstrsubsave(const char *begin, int len);
27
28 void miscerror(const char *what) NONRETURNING;
29 int makeroom(char **buffer, int *size, int needed);
30 /* makeroom returns -1 if needed was far too large; otherwise returns 0. */
31
32 /* It doesn't appear to be documented whether [v]snprintf put a null
33  * in if they overrun.  GNU libc does, but I don't want to rely on
34  * that.
35  * So here are some functions that always do, regardless - including
36  * versions of strcat and strcpy.  The ...nyt...cat functions take the
37  * maximum length of the resulting buffer as size parameter, rather
38  * than the maximum length of the added portion.
39  *
40  * So,
41  *   ...n...       specify copied length (inc. any null), may or may not null-terminate
42  *   ...ny...      specify copied length (inc. null) and always null-terminate
43  *   ...nyt...cat  specify total buffer length and always null-terminate
44  */
45
46 /* Function names best pronounced with a Russian accent. */
47 void vsnyprintf(char *buffer, size_t size, const char *fmt, va_list al);
48 void snyprintf(char *buffer, size_t size, const char *fmt, ...) PRINTFFORMAT(3,4);
49 void strnycpy(char *dest, const char *src, size_t size);
50
51 void vsnytprintfcat(char *buffer, size_t size, const char *fmt, va_list al);
52 void snytprintfcat(char *buffer, size_t size, const char *fmt, ...) PRINTFFORMAT(3,4);
53 void strnytcat(char *dest, const char *src, size_t size);
54
55 #ifndef HAVE_SETENV
56 int setenv(const char *name, const char *value, int overwrite);
57 #endif /* HAVE_SETENV */
58
59 #endif /* LIB_H */