Cyril Hrubis | bbdb9f7 | 2016-03-16 15:53:57 +0100 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (c) 2012-2016 Cyril Hrubis <chrubis@suse.cz> |
| 3 | * |
| 4 | * This program is free software: you can redistribute it and/or modify |
| 5 | * it under the terms of the GNU General Public License as published by |
| 6 | * the Free Software Foundation, either version 2 of the License, or |
| 7 | * (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 License |
| 15 | * along with this program. If not, see <http://www.gnu.org/licenses/>. |
| 16 | */ |
| 17 | |
| 18 | #ifndef SAFE_FILE_OPS_FN |
| 19 | #define SAFE_FILE_OPS_FN |
| 20 | |
| 21 | #include <sys/stat.h> |
| 22 | #include <time.h> |
| 23 | |
| 24 | #include "lapi/utime.h" |
| 25 | |
| 26 | /* |
| 27 | * All-in-one function to scanf value(s) from a file. |
| 28 | */ |
| 29 | int file_scanf(const char *file, const int lineno, |
| 30 | const char *path, const char *fmt, ...) |
| 31 | __attribute__ ((format (scanf, 4, 5))); |
| 32 | |
| 33 | void safe_file_scanf(const char *file, const int lineno, |
| 34 | void (*cleanup_fn)(void), |
| 35 | const char *path, const char *fmt, ...) |
| 36 | __attribute__ ((format (scanf, 5, 6))); |
| 37 | |
Jan Stancek | 9ff68de | 2016-07-14 12:35:22 +0200 | [diff] [blame] | 38 | int file_lines_scanf(const char *file, const int lineno, |
| 39 | void (*cleanup_fn)(void), int strict, |
| 40 | const char *path, const char *fmt, ...) |
| 41 | __attribute__ ((format (scanf, 6, 7))); |
| 42 | |
Cyril Hrubis | bbdb9f7 | 2016-03-16 15:53:57 +0100 | [diff] [blame] | 43 | /* |
| 44 | * All-in-one function that lets you printf directly into a file. |
| 45 | */ |
| 46 | int file_printf(const char *file, const int lineno, |
| 47 | const char *path, const char *fmt, ...) |
| 48 | __attribute__ ((format (printf, 4, 5))); |
| 49 | |
| 50 | void safe_file_printf(const char *file, const int lineno, |
| 51 | void (*cleanup_fn)(void), |
| 52 | const char *path, const char *fmt, ...) |
| 53 | __attribute__ ((format (printf, 5, 6))); |
| 54 | |
| 55 | /* |
| 56 | * Safe function to copy files, no more system("cp ...") please. |
| 57 | */ |
| 58 | void safe_cp(const char *file, const int lineno, |
| 59 | void (*cleanup_fn)(void), |
| 60 | const char *src, const char *dst); |
| 61 | |
| 62 | /* |
| 63 | * Safe function to touch a file. |
| 64 | * |
| 65 | * If the file (pathname) does not exist It will be created with |
| 66 | * the specified permission (mode) and the access/modification times (times). |
| 67 | * |
| 68 | * If mode is 0 then the file is created with (0666 & ~umask) |
| 69 | * permission or (if the file exists) the permission is not changed. |
| 70 | * |
| 71 | * times is a timespec[2] (as for utimensat(2)). If times is NULL then |
| 72 | * the access/modification times of the file is set to the current time. |
| 73 | */ |
| 74 | void safe_touch(const char *file, const int lineno, |
| 75 | void (*cleanup_fn)(void), |
| 76 | const char *pathname, |
| 77 | mode_t mode, const struct timespec times[2]); |
| 78 | |
| 79 | #endif /* SAFE_FILE_OPS_FN */ |