mirror of
https://github.com/amadvance/snapraid.git
synced 2026-10-26 10:51:54 -04:00
193 lines
4.7 KiB
C
193 lines
4.7 KiB
C
/*
|
|
* Copyright (C) 2011 Andrea Mazzoleni
|
|
*
|
|
* This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef __SUPPORT_H
|
|
#define __SUPPORT_H
|
|
|
|
/****************************************************************************/
|
|
/* log */
|
|
|
|
/**
|
|
* Output messages targgeted for the screen.
|
|
*
|
|
* Messages are in human readable format.
|
|
* They must include the full line output and terminate with '\n'.
|
|
*
|
|
* These messages go in the log file and in stdout.
|
|
*/
|
|
void fout(const char* format, ...) __attribute__((format(attribute_printf, 1, 2)));
|
|
|
|
/**
|
|
* Error messages printed before an early termination.
|
|
*
|
|
* Messages are in human readable format.
|
|
* They must include the full line output and terminate with '\n'.
|
|
*
|
|
* These messages go in the log file and in stderr.
|
|
*/
|
|
void ferr(const char* format, ...) __attribute__((format(attribute_printf, 1, 2)));
|
|
|
|
/**
|
|
* Log messages printed after an error.
|
|
*
|
|
* Messages are in human readable format.
|
|
* They must include the full line output and terminate with '\n'.
|
|
*
|
|
* These messages go in the log file if specified, otherwise in stderr.
|
|
*/
|
|
void flog(const char* format, ...) __attribute__((format(attribute_printf, 1, 2)));
|
|
|
|
/**
|
|
* Flush the log output.
|
|
*/
|
|
void fflush_log(void);
|
|
|
|
/**
|
|
* Tag messages.
|
|
*
|
|
* Messages are in tag format, like "tag:entry:...".
|
|
*
|
|
* These messages go in the log file.
|
|
*/
|
|
void ftag(const char* format, ...) __attribute__((format(attribute_printf, 1, 2)));
|
|
|
|
/**
|
|
* Pointer to log function.
|
|
*/
|
|
typedef void fptr(const char* format, ...);
|
|
|
|
/**
|
|
* Escape a string.
|
|
*
|
|
* Chars ':', '\n', '\r' and '\' are escaped to '\d', '\\n', '\\r' and '\\'.
|
|
*/
|
|
const char* esc(const char* str);
|
|
|
|
/****************************************************************************/
|
|
/* path */
|
|
|
|
/**
|
|
* Copies a path limiting the size.
|
|
* Aborts if too long.
|
|
*/
|
|
void pathcpy(char* dst, size_t size, const char* src);
|
|
|
|
/**
|
|
* Concatenates a path limiting the size.
|
|
* Aborts if too long.
|
|
*/
|
|
void pathcat(char* dst, size_t size, const char* src);
|
|
|
|
/**
|
|
* Concatenates a path limiting the size.
|
|
* Aborts if too long.
|
|
*/
|
|
void pathcatc(char* dst, size_t size, char c);
|
|
|
|
/**
|
|
* Imports a path limiting the size.
|
|
* In Windows all the backslash are converted to the C standard of forward slash.
|
|
* Aborts if too long.
|
|
*/
|
|
void pathimport(char* dst, size_t size, const char* src);
|
|
|
|
/**
|
|
* Exports a path limiting the size.
|
|
* In Windows all the C slashes are converted to the Windows backslash.
|
|
* Aborts if too long.
|
|
*/
|
|
void pathexport(char* dst, size_t size, const char* src);
|
|
|
|
/**
|
|
* Prints a path.
|
|
* Aborts if too long.
|
|
*/
|
|
void pathprint(char* dst, size_t size, const char* format, ...) __attribute__((format(attribute_printf, 3, 4)));
|
|
|
|
/**
|
|
* Ensures the presence of a terminating slash, if it isn't empty.
|
|
* Aborts if too long.
|
|
*/
|
|
void pathslash(char* dst, size_t size);
|
|
|
|
/**
|
|
* Cuts everything after the latest slash.
|
|
*/
|
|
void pathcut(char* dst);
|
|
|
|
/**
|
|
* Compare two paths.
|
|
* In Windows it's case insentive and assumes \ equal at /.
|
|
*/
|
|
int pathcmp(const char* a, const char* b);
|
|
|
|
/****************************************************************************/
|
|
/* filesystem */
|
|
|
|
/**
|
|
* Creates all the ancestor directories if missing.
|
|
* The file name, after the last /, is ignored.
|
|
*/
|
|
int mkancestor(const char* file);
|
|
|
|
/**
|
|
* Changes the modification time of an open file.
|
|
*/
|
|
int fmtime(int f, int64_t mtime_sec, int mtime_nsec);
|
|
|
|
/****************************************************************************/
|
|
/* memory */
|
|
|
|
/**
|
|
* Return the size of the allocated memory.
|
|
*/
|
|
size_t malloc_counter(void);
|
|
|
|
/**
|
|
* Safe malloc.
|
|
* If no memory is available, it aborts.
|
|
*/
|
|
void* malloc_nofail(size_t size);
|
|
|
|
/**
|
|
* Safe cmalloc.
|
|
* If no memory is available, it aborts.
|
|
*/
|
|
void* calloc_nofail(size_t count, size_t size);
|
|
|
|
/**
|
|
* Safe strdup.
|
|
* If no memory is available, it aborts.
|
|
*/
|
|
char* strdup_nofail(const char* str);
|
|
|
|
/**
|
|
* Helper for printing an error about a failed allocation.
|
|
*/
|
|
void malloc_fail(size_t size);
|
|
|
|
/****************************************************************************/
|
|
/* smartctl */
|
|
|
|
/**
|
|
* Reads smartctl attributes from a stream.
|
|
* Returns 0 on success.
|
|
*/
|
|
int smartctl_attribute(FILE* f, uint64_t* smart, char* serial);
|
|
|
|
#endif
|
|
|