Index: uspace/lib/posix/Makefile =================================================================== --- uspace/lib/posix/Makefile (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/Makefile (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -63,3 +63,2 @@ $(INCLUDE_LIBC): ../c/include ln -s -f -n $^ $@ - Index: uspace/lib/posix/assert.h =================================================================== --- uspace/lib/posix/assert.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/assert.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Program assertion. */ @@ -52,3 +52,2 @@ /** @} */ - Index: uspace/lib/posix/errno.c =================================================================== --- uspace/lib/posix/errno.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/errno.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file System error numbers. */ @@ -51,3 +51,2 @@ /** @} */ - Index: uspace/lib/posix/errno.h =================================================================== --- uspace/lib/posix/errno.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/errno.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file System error numbers. */ @@ -325,3 +325,2 @@ /** @} */ - Index: uspace/lib/posix/fcntl.c =================================================================== --- uspace/lib/posix/fcntl.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/fcntl.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file File control. */ Index: uspace/lib/posix/fcntl.h =================================================================== --- uspace/lib/posix/fcntl.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/fcntl.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file File control. */ Index: uspace/lib/posix/float.h =================================================================== --- uspace/lib/posix/float.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/float.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Floating type support. */ Index: uspace/lib/posix/fnmatch.c =================================================================== --- uspace/lib/posix/fnmatch.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/fnmatch.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Filename-matching. */ @@ -45,4 +45,6 @@ #include "internal/common.h" #include "fnmatch.h" + +// TODO: documentation #define INVALID_PATTERN -1 @@ -169,4 +171,10 @@ }; +/** + * + * @param key + * @param elem + * @return + */ static int _class_compare(const void *key, const void *elem) { @@ -175,4 +183,10 @@ } +/** + * + * @param cname + * @param c + * @return + */ static bool _is_in_class (const char *cname, int c) { @@ -191,4 +205,11 @@ } +/** + * + * @param pattern + * @param str + * @param flags + * @return + */ static int _match_char_class(const char **pattern, const char *str, int flags) { @@ -204,4 +225,10 @@ /************** END CHARACTER CLASSES ****************/ +/** + * + * @param pattern + * @param flags + * @return + */ static _coll_elm_t _next_coll_elm(const char **pattern, int flags) { @@ -240,5 +267,9 @@ /** - * + * + * @param pattern + * @param str + * @param flags + * @return */ static int _match_bracket_expr(const char **pattern, const char *str, int flags) @@ -327,5 +358,9 @@ /** - * + * + * @param pattern + * @param string + * @param flags + * @return */ static bool _partial_match(const char **pattern, const char **string, int flags) @@ -421,4 +456,11 @@ } +/** + * + * @param pattern + * @param string + * @param flags + * @return + */ static bool _full_match(const char *pattern, const char *string, int flags) { @@ -476,4 +518,9 @@ } +/** + * + * @param s + * @return + */ static char *_casefold(const char *s) { @@ -604,3 +651,2 @@ /** @} */ - Index: uspace/lib/posix/fnmatch.h =================================================================== --- uspace/lib/posix/fnmatch.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/fnmatch.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Filename-matching. */ @@ -36,5 +36,5 @@ #define POSIX_FNMATCH_H_ -/* Error Values. */ +/* Error Values */ #undef FNM_NOMATCH #define FNM_NOMATCH 1 @@ -66,3 +66,2 @@ /** @} */ - Index: uspace/lib/posix/internal/common.h =================================================================== --- uspace/lib/posix/internal/common.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/internal/common.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Helper definitions common for all libposix files. */ Index: uspace/lib/posix/inttypes.h =================================================================== --- uspace/lib/posix/inttypes.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/inttypes.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Fixed size integer types. */ Index: uspace/lib/posix/iso646.h =================================================================== --- uspace/lib/posix/iso646.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/iso646.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -1,7 +1,34 @@ +/* + * Copyright (c) 2011 Jiri Zarevucky + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * - Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * - Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * - The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ /** @addtogroup libposix * @{ */ -/** @file +/** @file Alternative spellings. */ @@ -25,3 +52,2 @@ /** @} */ - Index: uspace/lib/posix/limits.h =================================================================== --- uspace/lib/posix/limits.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/limits.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Implementation-defined limit constants. */ Index: uspace/lib/posix/locale.c =================================================================== --- uspace/lib/posix/locale.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/locale.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Locale-specific definitions. */ @@ -41,4 +41,6 @@ #include "limits.h" #include "string.h" + +// TODO: documentation struct __posix_locale { @@ -73,4 +75,10 @@ }; +/** + * + * @param category + * @param locale + * @return + */ char *posix_setlocale(int category, const char *locale) { @@ -83,4 +91,8 @@ } +/** + * + * @return + */ struct posix_lconv *posix_localeconv(void) { @@ -89,4 +101,9 @@ } +/** + * + * @param locobj + * @return + */ posix_locale_t posix_duplocale(posix_locale_t locobj) { @@ -104,4 +121,8 @@ } +/** + * + * @param locobj + */ void posix_freelocale(posix_locale_t locobj) { @@ -109,4 +130,11 @@ } +/** + * + * @param category_mask + * @param locale + * @param base + * @return + */ posix_locale_t posix_newlocale(int category_mask, const char *locale, posix_locale_t base) @@ -129,5 +157,10 @@ } -posix_locale_t posix_uselocale (posix_locale_t newloc) +/** + * + * @param newloc + * @return + */ +posix_locale_t posix_uselocale(posix_locale_t newloc) { // TODO Index: uspace/lib/posix/locale.h =================================================================== --- uspace/lib/posix/locale.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/locale.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,9 +30,11 @@ * @{ */ -/** @file +/** @file Locale-specific definitions. */ #ifndef POSIX_LOCALE_H_ #define POSIX_LOCALE_H_ + +// TODO: documentation #ifndef NULL @@ -83,28 +85,28 @@ struct posix_lconv { - char *currency_symbol; - char *decimal_point; - char frac_digits; - char *grouping; - char *int_curr_symbol; - char int_frac_digits; - char int_n_cs_precedes; - char int_n_sep_by_space; - char int_n_sign_posn; - char int_p_cs_precedes; - char int_p_sep_by_space; - char int_p_sign_posn; - char *mon_decimal_point; - char *mon_grouping; - char *mon_thousands_sep; - char *negative_sign; - char n_cs_precedes; - char n_sep_by_space; - char n_sign_posn; - char *positive_sign; - char p_cs_precedes; - char p_sep_by_space; - char p_sign_posn; - char *thousands_sep; + char *currency_symbol; + char *decimal_point; + char frac_digits; + char *grouping; + char *int_curr_symbol; + char int_frac_digits; + char int_n_cs_precedes; + char int_n_sep_by_space; + char int_n_sign_posn; + char int_p_cs_precedes; + char int_p_sep_by_space; + char int_p_sign_posn; + char *mon_decimal_point; + char *mon_grouping; + char *mon_thousands_sep; + char *negative_sign; + char n_cs_precedes; + char n_sep_by_space; + char n_sign_posn; + char *positive_sign; + char p_cs_precedes; + char p_sep_by_space; + char p_sign_posn; + char *thousands_sep; }; @@ -117,5 +119,5 @@ extern posix_locale_t posix_newlocale(int category_mask, const char *locale, posix_locale_t base); -extern posix_locale_t posix_uselocale (posix_locale_t newloc); +extern posix_locale_t posix_uselocale(posix_locale_t newloc); #ifndef LIBPOSIX_INTERNAL @@ -131,5 +133,4 @@ #endif - #endif /* POSIX_LOCALE_H_ */ Index: uspace/lib/posix/math.c =================================================================== --- uspace/lib/posix/math.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/math.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Mathematical operations. */ Index: uspace/lib/posix/math.h =================================================================== --- uspace/lib/posix/math.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/math.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Mathematical operations. */ Index: uspace/lib/posix/pwd.c =================================================================== --- uspace/lib/posix/pwd.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/pwd.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,12 +30,14 @@ * @{ */ -/** @file +/** @file Password handling. */ #define LIBPOSIX_INTERNAL + #include "pwd.h" #include "string.h" #include "errno.h" +// TODO: documentation static bool entry_read = false; @@ -53,4 +55,6 @@ * Since HelenOS doesn't have user accounts, this always returns * the same made-up entry. + * + * @return */ struct posix_passwd *posix_getpwent(void) @@ -178,3 +182,2 @@ /** @} */ - Index: uspace/lib/posix/pwd.h =================================================================== --- uspace/lib/posix/pwd.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/pwd.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,9 +30,11 @@ * @{ */ -/** @file +/** @file Password handling. */ #ifndef POSIX_PWD_H_ #define POSIX_PWD_H_ + +// TODO: documentation #include "sys/types.h" @@ -76,3 +78,2 @@ /** @} */ - Index: uspace/lib/posix/signal.c =================================================================== --- uspace/lib/posix/signal.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/signal.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Signal handling. */ @@ -45,4 +45,6 @@ #include "libc/task.h" +// TODO: documentation + /* Used to serialize signal handling. */ static FIBRIL_MUTEX_INITIALIZE(_signal_mutex); @@ -63,4 +65,8 @@ }; +/** + * + * @param signo + */ void __posix_default_signal_handler(int signo) { @@ -118,4 +124,8 @@ } +/** + * + * @param signo + */ void __posix_hold_signal_handler(int signo) { @@ -123,4 +133,8 @@ } +/** + * + * @param signo + */ void __posix_ignore_signal_handler(int signo) { @@ -128,5 +142,9 @@ } - +/** + * + * @param set + * @return + */ int posix_sigemptyset(posix_sigset_t *set) { @@ -137,4 +155,9 @@ } +/** + * + * @param set + * @return + */ int posix_sigfillset(posix_sigset_t *set) { @@ -145,4 +168,10 @@ } +/** + * + * @param set + * @param signo + * @return + */ int posix_sigaddset(posix_sigset_t *set, int signo) { @@ -153,4 +182,10 @@ } +/** + * + * @param set + * @param signo + * @return + */ int posix_sigdelset(posix_sigset_t *set, int signo) { @@ -161,4 +196,10 @@ } +/** + * + * @param set + * @param signo + * @return + */ int posix_sigismember(const posix_sigset_t *set, int signo) { @@ -168,4 +209,10 @@ } +/** + * + * @param sig + * @param act + * @param oact + */ static void _sigaction_unsafe(int sig, const struct posix_sigaction *restrict act, struct posix_sigaction *restrict oact) @@ -182,4 +229,11 @@ } +/** + * + * @param sig + * @param act + * @param oact + * @return + */ int posix_sigaction(int sig, const struct posix_sigaction *restrict act, struct posix_sigaction *restrict oact) @@ -206,4 +260,10 @@ } +/** + * + * @param sig + * @param func + * @return + */ void (*posix_signal(int sig, void (*func)(int)))(int) { @@ -222,4 +282,10 @@ } +/** + * + * @param signo + * @param siginfo + * @return + */ static int _raise_sigaction(int signo, posix_siginfo_t *siginfo) { @@ -259,4 +325,9 @@ } +/** + * + * @param sig + * @return + */ int posix_raise(int sig) { @@ -273,4 +344,10 @@ } +/** + * + * @param pid + * @param signo + * @return + */ int posix_kill(posix_pid_t pid, int signo) { @@ -303,4 +380,10 @@ } +/** + * + * @param pid + * @param sig + * @return + */ int posix_killpg(posix_pid_t pid, int sig) { @@ -309,4 +392,9 @@ } +/** + * + * @param pinfo + * @param message + */ void posix_psiginfo(const posix_siginfo_t *pinfo, const char *message) { @@ -316,4 +404,9 @@ } +/** + * + * @param signum + * @param message + */ void posix_psignal(int signum, const char *message) { @@ -326,4 +419,11 @@ } +/** + * + * @param how + * @param set + * @param oset + * @return + */ int posix_thread_sigmask(int how, const posix_sigset_t *restrict set, posix_sigset_t *restrict oset) @@ -358,4 +458,11 @@ } +/** + * + * @param how + * @param set + * @param oset + * @return + */ int posix_sigprocmask(int how, const posix_sigset_t *restrict set, posix_sigset_t *restrict oset) @@ -371,3 +478,2 @@ /** @} */ - Index: uspace/lib/posix/signal.h =================================================================== --- uspace/lib/posix/signal.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/signal.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,9 +30,11 @@ * @{ */ -/** @file +/** @file Signal handling. */ #ifndef POSIX_SIGNAL_H_ #define POSIX_SIGNAL_H_ + +// TODO: documentation #include "libc/errno.h" @@ -107,5 +109,4 @@ posix_mcontext_t uc_mcontext; } posix_ucontext_t; - /* Values of posix_sigevent::sigev_notify */ @@ -154,5 +155,5 @@ #define SIGSTKSZ 0 -/* full POSIX set */ +/* Full POSIX set */ enum { /* Termination Signals */ @@ -214,5 +215,4 @@ /* Values for sigaction field si_code. */ - enum { SI_USER, @@ -287,9 +287,10 @@ #define sigevent posix_sigevent #endif - #define sigaction posix_sigaction #define mcontext_t posix_mcontext_t #define ucontext_t posix_ucontext_t #define stack_t posix_stack_t #define siginfo_t posix_siginfo_t + + #define sigaction posix_sigaction #define signal posix_signal Index: uspace/lib/posix/stdbool.h =================================================================== --- uspace/lib/posix/stdbool.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/stdbool.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Boolean type and values. */ @@ -50,3 +50,2 @@ #endif /* POSIX_STDBOOL_H_ */ - Index: uspace/lib/posix/stddef.h =================================================================== --- uspace/lib/posix/stddef.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/stddef.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Standard type definitions. */ Index: uspace/lib/posix/stdint.h =================================================================== --- uspace/lib/posix/stdint.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/stdint.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Integer types. */ Index: uspace/lib/posix/stdio.c =================================================================== --- uspace/lib/posix/stdio.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/stdio.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -31,5 +31,5 @@ * @{ */ -/** @file +/** @file Standard buffered input/output. */ Index: uspace/lib/posix/stdio.h =================================================================== --- uspace/lib/posix/stdio.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/stdio.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -31,5 +31,5 @@ * @{ */ -/** @file +/** @file Standard buffered input/output. */ Index: uspace/lib/posix/stdlib/strtold.c =================================================================== --- uspace/lib/posix/stdlib/strtold.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/stdlib/strtold.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -513,5 +513,5 @@ * @param nptr Input string. * @param endptr If non-NULL, *endptr is set to the position of the first - * unrecognized character. + * unrecognized character. * @return An approximate representation of the input floating-point number. */ Index: uspace/lib/posix/string.h =================================================================== --- uspace/lib/posix/string.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/string.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -106,5 +106,5 @@ extern char *posix_strsignal(int signum); -/* Legacy declarations */ +/* Legacy Declarations */ #ifndef POSIX_STRINGS_H_ extern int posix_ffs(int i); Index: uspace/lib/posix/sys/mman.h =================================================================== --- uspace/lib/posix/sys/mman.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/sys/mman.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Memory management declarations. */ Index: uspace/lib/posix/sys/stat.c =================================================================== --- uspace/lib/posix/sys/stat.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/sys/stat.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -31,5 +31,5 @@ * @{ */ -/** @file +/** @file File status handling. */ @@ -80,6 +80,5 @@ int rc = fstat(fd, &hst); if (rc < 0) { - /* fstat() returns negative error code instead of using errno. - */ + /* fstat() returns negative error code instead of using errno. */ errno = -rc; return -1; @@ -96,5 +95,5 @@ * @return Zero on success, -1 otherwise. */ -int posix_lstat(const char *path, struct posix_stat *st) +int posix_lstat(const char *restrict path, struct posix_stat *restrict st) { /* There are currently no symbolic links in HelenOS. */ @@ -109,11 +108,10 @@ * @return Zero on success, -1 otherwise. */ -int posix_stat(const char *path, struct posix_stat *st) +int posix_stat(const char *restrict path, struct posix_stat *restrict st) { struct stat hst; int rc = stat(path, &hst); if (rc < 0) { - /* stat() returns negative error code instead of using errno. - */ + /* stat() returns negative error code instead of using errno. */ errno = -rc; return -1; Index: uspace/lib/posix/sys/stat.h =================================================================== --- uspace/lib/posix/sys/stat.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/sys/stat.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -31,5 +31,5 @@ * @{ */ -/** @file +/** @file File status handling. */ Index: uspace/lib/posix/sys/types.h =================================================================== --- uspace/lib/posix/sys/types.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/sys/types.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -31,5 +31,5 @@ * @{ */ -/** @file +/** @file Data types definitions. */ @@ -49,8 +49,8 @@ typedef sysarg_t posix_dev_t; -/* PThread types */ +/* PThread Types */ typedef struct posix_thread_attr posix_thread_attr_t; -/* Clock types */ +/* Clock Types */ typedef long posix_clock_t; typedef int posix_clockid_t; Index: uspace/lib/posix/sys/wait.c =================================================================== --- uspace/lib/posix/sys/wait.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/sys/wait.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -31,5 +31,5 @@ * @{ */ -/** @file +/** @file Support for waiting. */ @@ -65,3 +65,2 @@ /** @} */ - Index: uspace/lib/posix/sys/wait.h =================================================================== --- uspace/lib/posix/sys/wait.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/sys/wait.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -30,5 +30,5 @@ * @{ */ -/** @file +/** @file Support for waiting. */ Index: uspace/lib/posix/time.c =================================================================== --- uspace/lib/posix/time.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/time.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -31,5 +31,5 @@ * @{ */ -/** @file +/** @file Time measurement support. */ @@ -63,4 +63,9 @@ #define SECS_PER_DAY (SECS_PER_HOUR * HOURS_PER_DAY) +/** + * + * @param year + * @return + */ static bool _is_leap_year(time_t year) { @@ -76,4 +81,10 @@ } +/** + * + * @param year + * @param mon + * @return + */ static int _days_in_month(time_t year, time_t mon) { @@ -92,4 +103,11 @@ } +/** + * + * @param year + * @param mon + * @param mday + * @return + */ static int _day_of_year(time_t year, time_t mon, time_t mday) { @@ -102,5 +120,10 @@ } -/* Integer division that rounds to negative infinity. +/** + * Integer division that rounds to negative infinity. + * + * @param op1 + * @param op2 + * @return */ static time_t _floor_div(time_t op1, time_t op2) @@ -113,5 +136,10 @@ } -/* Modulo that rounds to negative infinity. +/** + * Modulo that rounds to negative infinity. + * + * @param op1 + * @param op2 + * @return */ static time_t _floor_mod(time_t op1, time_t op2) @@ -132,4 +160,11 @@ } +/** + * + * @param year + * @param mon + * @param mday + * @return + */ static time_t _days_since_epoch(time_t year, time_t mon, time_t mday) { @@ -139,5 +174,10 @@ } -/* Assumes normalized broken-down time. */ +/** + * Assumes normalized broken-down time. + * + * @param tm + * @return + */ static time_t _secs_since_epoch(const struct posix_tm *tm) { @@ -147,4 +187,11 @@ } +/** + * + * @param year + * @param mon + * @param mday + * @return + */ static int _day_of_week(time_t year, time_t mon, time_t mday) { @@ -165,4 +212,9 @@ }; +/** + * + * @param ltm + * @param ptm + */ static void _posix_to_long_tm(struct _long_tm *ltm, struct posix_tm *ptm) { @@ -179,4 +231,9 @@ } +/** + * + * @param ptm + * @param ltm + */ static void _long_to_posix_tm(struct posix_tm *ptm, struct _long_tm *ltm) { @@ -196,4 +253,8 @@ } +/** + * + * @param tm + */ static void _normalize_time(struct _long_tm *tm) { @@ -241,6 +302,10 @@ } -/* Which day the week-based year starts on relative to the first calendar day. +/** + * Which day the week-based year starts on relative to the first calendar day. * E.g. if the year starts on December 31st, the return value is -1. + * + * @param year + * @return */ static int _wbyear_offset(int year) @@ -250,6 +315,10 @@ } -/* Returns week-based year of the specified time. +/** + * Returns week-based year of the specified time. * Assumes normalized broken-down time. + * + * @param tm + * @return */ static int _wbyear(const struct posix_tm *tm) @@ -268,7 +337,8 @@ } -/** Week number of the year, assuming weeks start on sunday. - * The first Sunday of January is the first day of week 1; - * days in the new year before this are in week 0. +/** + * Week number of the year, assuming weeks start on sunday. + * The first Sunday of January is the first day of week 1; + * days in the new year before this are in week 0. * * @param tm Normalized broken-down time. @@ -281,9 +351,10 @@ } -/** Week number of the year, assuming weeks start on monday. - * If the week containing January 1st has four or more days in the new year, - * then it is considered week 1. Otherwise, it is the last week of the previous - * year, and the next week is week 1. Both January 4th and the first Thursday - * of January are always in week 1. +/** + * Week number of the year, assuming weeks start on monday. + * If the week containing January 1st has four or more days in the new year, + * then it is considered week 1. Otherwise, it is the last week of the previous + * year, and the next week is week 1. Both January 4th and the first Thursday + * of January are always in week 1. * * @param tm Normalized broken-down time. @@ -305,7 +376,8 @@ } -/** Week number of the year, assuming weeks start on monday. - * The first Monday of January is the first day of week 1; - * days in the new year before this are in week 0. +/** + * Week number of the year, assuming weeks start on monday. + * The first Monday of January is the first day of week 1; + * days in the new year before this are in week 0. * * @param tm Normalized broken-down time. @@ -324,4 +396,7 @@ char *posix_tzname[2]; +/** + * + */ void posix_tzset(void) { @@ -333,4 +408,10 @@ } +/** + * + * @param time1 + * @param time0 + * @return + */ double posix_difftime(time_t time1, time_t time0) { @@ -338,9 +419,10 @@ } -/** This function first normalizes the provided broken-down time - * (moves all values to their proper bounds) and then tries to - * calculate the appropriate time_t representation. - * - * @param timeptr Broken-down time. +/** + * This function first normalizes the provided broken-down time + * (moves all values to their proper bounds) and then tries to + * calculate the appropriate time_t representation. + * + * @param tm Broken-down time. * @return time_t representation of the time, undefined value on overflow */ @@ -358,4 +440,9 @@ } +/** + * + * @param timer + * @return + */ struct posix_tm *posix_gmtime(const time_t *timer) { @@ -364,4 +451,10 @@ } +/** + * + * @param timer + * @param result + * @return + */ struct posix_tm *posix_gmtime_r(const time_t *restrict timer, struct posix_tm *restrict result) @@ -394,5 +487,5 @@ /** * - * @param timep + * @param timer * @return */ @@ -403,4 +496,10 @@ } +/** + * + * @param timer + * @param result + * @return + */ struct posix_tm *posix_localtime_r(const time_t *restrict timer, struct posix_tm *restrict result) @@ -413,5 +512,5 @@ /** * - * @param tm + * @param timeptr * @return */ @@ -422,4 +521,10 @@ } +/** + * + * @param timeptr + * @param buf + * @return + */ char *posix_asctime_r(const struct posix_tm *restrict timeptr, char *restrict buf) @@ -448,5 +553,5 @@ /** * - * @param timep + * @param timer * @return */ @@ -460,4 +565,10 @@ } +/** + * + * @param timer + * @param buf + * @return + */ char *posix_ctime_r(const time_t *timer, char *buf) { @@ -477,6 +588,6 @@ * @return */ -size_t posix_strftime(char *s, size_t maxsize, - const char *format, const struct posix_tm *tm) +size_t posix_strftime(char *restrict s, size_t maxsize, + const char *restrict format, const struct posix_tm *restrict tm) { // TODO: use locale @@ -655,4 +766,27 @@ } +/** + * + * @param s + * @param maxsize + * @param format + * @param tm + * @param loc + * @return + */ +extern size_t posix_strftime_l(char *restrict s, size_t maxsize, + const char *restrict format, const struct posix_tm *restrict tm, + posix_locale_t loc) +{ + // TODO + not_implemented(); +} + +/** + * + * @param clock_id + * @param res + * @return + */ int posix_clock_getres(posix_clockid_t clock_id, struct posix_timespec *res) { @@ -670,4 +804,10 @@ } +/** + * + * @param clock_id + * @param tp + * @return + */ int posix_clock_gettime(posix_clockid_t clock_id, struct posix_timespec *tp) { @@ -688,4 +828,10 @@ } +/** + * + * @param clock_id + * @param tp + * @return + */ int posix_clock_settime(posix_clockid_t clock_id, const struct posix_timespec *tp) @@ -706,4 +852,12 @@ } +/** + * + * @param clock_id + * @param flags + * @param rqtp + * @param rmtp + * @return + */ int posix_clock_nanosleep(posix_clockid_t clock_id, int flags, const struct posix_timespec *rqtp, struct posix_timespec *rmtp) @@ -735,4 +889,11 @@ }; +/** + * + * @param clockid + * @param evp + * @param timerid + * @return + */ int posix_timer_create(posix_clockid_t clockid, struct posix_sigevent *restrict evp, @@ -743,4 +904,9 @@ } +/** + * + * @param timerid + * @return + */ int posix_timer_delete(posix_timer_t timerid) { @@ -749,4 +915,9 @@ } +/** + * + * @param timerid + * @return + */ int posix_timer_getoverrun(posix_timer_t timerid) { @@ -755,4 +926,10 @@ } +/** + * + * @param timerid + * @param value + * @return + */ int posix_timer_gettime(posix_timer_t timerid, struct posix_itimerspec *value) @@ -762,4 +939,12 @@ } +/** + * + * @param timerid + * @param flags + * @param value + * @param ovalue + * @return + */ int posix_timer_settime(posix_timer_t timerid, int flags, const struct posix_itimerspec *restrict value, Index: uspace/lib/posix/time.h =================================================================== --- uspace/lib/posix/time.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/time.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -31,5 +31,5 @@ * @{ */ -/** @file +/** @file Time measurement support. */ @@ -94,17 +94,14 @@ /* Timezones */ - extern int posix_daylight; extern long posix_timezone; extern char *posix_tzname[2]; - extern void posix_tzset(void); -/* time_t */ - +/* Elapsed Time */ extern double posix_difftime(time_t time1, time_t time0); /* Broken-down Time */ -extern time_t posix_mktime(struct posix_tm *timeptr); +extern time_t posix_mktime(struct posix_tm *tm); extern struct posix_tm *posix_gmtime(const time_t *timer); extern struct posix_tm *posix_gmtime_r(const time_t *restrict timer, @@ -120,14 +117,11 @@ extern char *posix_ctime(const time_t *timer); extern char *posix_ctime_r(const time_t *timer, char *buf); - extern size_t posix_strftime(char *restrict s, size_t maxsize, const char *restrict format, const struct posix_tm *restrict tm); - extern size_t posix_strftime_l(char *restrict s, size_t maxsize, const char *restrict format, const struct posix_tm *restrict tm, posix_locale_t loc); -/* Clocks. */ - +/* Clocks */ extern int posix_clock_getres(posix_clockid_t clock_id, struct posix_timespec *res); @@ -139,8 +133,7 @@ const struct posix_timespec *rqtp, struct posix_timespec *rmtp); -/* Timers. */ - #if 0 +/* Timers */ extern int posix_timer_create(posix_clockid_t clockid, struct posix_sigevent *restrict evp, @@ -159,13 +152,17 @@ extern posix_clock_t posix_clock(void); - #ifndef LIBPOSIX_INTERNAL #define tm posix_tm - #define timespec posix_timespec #define itimerspec posix_itimerspec #define timer_t posix_timer_t + #define daylight posix_daylight + #define timezone posix_timezone + #define tzname posix_tzname + #define tzset posix_tzset + #define difftime posix_difftime + #define mktime posix_mktime #define gmtime posix_gmtime @@ -174,9 +171,4 @@ #define localtime_r posix_localtime_r - #define daylight posix_daylight - #define timezone posix_timezone - #define tzname posix_tzname - #define tzset posix_tzset - #define asctime posix_asctime #define asctime_r posix_asctime_r @@ -184,4 +176,5 @@ #define ctime_r posix_ctime_r #define strftime posix_strftime + #define strftime_l posix_strftime_l #define clock_getres posix_clock_getres Index: uspace/lib/posix/unistd.c =================================================================== --- uspace/lib/posix/unistd.c (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/unistd.c (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -31,5 +31,5 @@ * @{ */ -/** @file +/** @file Miscellaneous standard definitions. */ Index: uspace/lib/posix/unistd.h =================================================================== --- uspace/lib/posix/unistd.h (revision 102a729e88b697a95ed9ce5fbcd3097ac1b9b456) +++ uspace/lib/posix/unistd.h (revision 4cf8ca61cc35aeda46798f204c02a5e2e8af6c09) @@ -31,5 +31,5 @@ * @{ */ -/** @file +/** @file Miscellaneous standard definitions. */