File: lib.h

package info (click to toggle)
userv 1.2.0
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid, stretch
  • size: 700 kB
  • ctags: 1,013
  • sloc: ansic: 4,220; lex: 287; sh: 207; makefile: 206
file content (61 lines) | stat: -rw-r--r-- 2,512 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
/*
 * userv - lib.c
 * useful utility routines' imports and exports, used in daemon
 *
 * userv is
 * Copyright 1996-2017 Ian Jackson <ian@davenant.greenend.org.uk>.
 * Copyright 2000      Ben Harris <bjh21@cam.ac.uk>
 * Copyright 2016-2017 Peter Benie <pjb1008@cam.ac.uk>
 *
 * This is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with userv; if not, see <http://www.gnu.org/licenses/>.
 */

#ifndef LIB_H
#define LIB_H

char *xstrcat3save(const char *a, const char *b, const char *c);
char *xstrsubsave(const char *begin, int len);

void miscerror(const char *what) NONRETURNING;
int makeroom(char **buffer, int *size, int needed);
/* makeroom returns -1 if needed was far too large; otherwise returns 0. */

/* It doesn't appear to be documented whether [v]snprintf put a null
 * in if they overrun.  GNU libc does, but I don't want to rely on
 * that.
 * So here are some functions that always do, regardless - including
 * versions of strcat and strcpy.  The ...nyt...cat functions take the
 * maximum length of the resulting buffer as size parameter, rather
 * than the maximum length of the added portion.
 *
 * So,
 *   ...n...       specify copied length (inc. any null), may or may not null-terminate
 *   ...ny...      specify copied length (inc. null) and always null-terminate
 *   ...nyt...cat  specify total buffer length and always null-terminate
 */

/* Function names best pronounced with a Russian accent. */
void vsnyprintf(char *buffer, size_t size, const char *fmt, va_list al);
void snyprintf(char *buffer, size_t size, const char *fmt, ...) PRINTFFORMAT(3,4);
void strnycpy(char *dest, const char *src, size_t size);

void vsnytprintfcat(char *buffer, size_t size, const char *fmt, va_list al);
void snytprintfcat(char *buffer, size_t size, const char *fmt, ...) PRINTFFORMAT(3,4);
void strnytcat(char *dest, const char *src, size_t size);

#ifndef HAVE_SETENV
int setenv(const char *name, const char *value, int overwrite);
#endif /* HAVE_SETENV */

#endif /* LIB_H */