diff options
| -rw-r--r-- | include/fcntl.h | 56 | ||||
| -rw-r--r-- | src/fcntl/creat.c | 44 |
2 files changed, 100 insertions, 0 deletions
diff --git a/include/fcntl.h b/include/fcntl.h new file mode 100644 index 0000000..02230c7 --- /dev/null +++ b/include/fcntl.h @@ -0,0 +1,56 @@ +/** + * slibc — Yet another C library + * Copyright © 2015 Mattias Andrée (maandree@member.fsf.org) + * + * 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 _FCNTL_H +#define _FCNTL_H +#include <slibc/version.h> +#include <slibc/features.h> + + + +#define __NEED_off_t +#define __NEED_pid_t +#define __NEED_mode_t +#include <bits/types.h> + + + +/** + * Create a new file and open it for writing, or + * if the file already exists, open it for rewriting, + * in which the file will be emptied. + * + * `creat(path, mode)` is identical to + * `open(path, O_WRONLY | O_CREAT | O_TRUNC, mode)`. + * + * @etymology (Creat)e file! + * + * @param path The pathname of the file to open. + * @param mode File permissions for the new file. + * @return The file descriptor to the opened file, -1 on error. + * + * @throws Any error specified for open(3) except for `EEXIST`. + * + * @since Always. + */ +int creat(const char*, mode_t) + __deprecated("Use 'open' instead."); + + + +#endif + diff --git a/src/fcntl/creat.c b/src/fcntl/creat.c new file mode 100644 index 0000000..0d52d50 --- /dev/null +++ b/src/fcntl/creat.c @@ -0,0 +1,44 @@ +/** + * slibc — Yet another C library + * Copyright © 2015 Mattias Andrée (maandree@member.fsf.org) + * + * 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/>. + */ +#include <fcntl.h> + + + +/** + * Create a new file and open it for writing, or + * if the file already exists, open it for rewriting, + * in which the file will be emptied. + * + * `creat(path, mode)` is identical to + * `open(path, O_WRONLY | O_CREAT | O_TRUNC, mode)`. + * + * @etymology (Creat)e file! + * + * @param path The pathname of the file to open. + * @param mode File permissions for the new file. + * @return The file descriptor to the opened file, -1 on error. + * + * @throws Any error specified for open(3) except for `EEXIST`. + * + * @since Always. + */ +int creat(const char* path, mode_t mode) +{ + return open(path, O_WRONLY | O_CREAT | O_TRUNC, mode); +} + |