Changeset 38aaacc2 in mainline for uspace/app/sbi/src/os/posix.c


Ignore:
Timestamp:
2010-04-23T21:41:10Z (14 years ago)
Author:
Jiri Svoboda <jiri@…>
Branches:
lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export
Children:
f4f866c
Parents:
074444f
Message:

Update SBI to rev. 207.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • uspace/app/sbi/src/os/posix.c

    r074444f r38aaacc2  
    4747 * The string functions are in fact standard C, but would not work under
    4848 * HelenOS.
    49  */
    50 
    51 /** Concatenate two strings. */
     49 *
     50 * XXX String functions used here only work with 8-bit text encoding.
     51 */
     52
     53/** Concatenate two strings.
     54 *
     55 * @param a     First string
     56 * @param b     Second string
     57 * @return      New string, concatenation of @a a and @a b.
     58 */
    5259char *os_str_acat(const char *a, const char *b)
    5360{
    … …  
    7178}
    7279
    73 /** Compare two strings. */
     80/** Compare two strings.
     81 *
     82 * @param a     First string
     83 * @param b     Second string
     84 * @return      Zero if equal, nonzero if not equal
     85 */
    7486int os_str_cmp(const char *a, const char *b)
    7587{
    … …  
    7789}
    7890
    79 /** Return number of characters in string. */
     91/** Return number of characters in string.
     92 *
     93 * @param str   String
     94 * @return      Number of characters in @a str.
     95 */
    8096size_t os_str_length(const char *str)
    8197{
    … …  
    8399}
    84100
    85 /** Duplicate string. */
     101/** Duplicate string.
     102 *
     103 * @param str   String
     104 * @return      New string, duplicate of @a str.
     105 */
    86106char *os_str_dup(const char *str)
    87107{
    … …  
    89109}
    90110
    91 /** Get character from string at the given index. */
     111/** Get character from string at the given index.
     112 *
     113 * @param str           String
     114 * @param index         Character index (starting from zero).
     115 * @param out_char      Place to store character.
     116 * @return              EOK on success, EINVAL if index is out of bounds,
     117 *                      EIO on decoding error.
     118 */
    92119int os_str_get_char(const char *str, int index, int *out_char)
    93120{
    … …  
    111138}
    112139
    113 /** Read one line of input from the user. */
     140/** Read one line of input from the user.
     141 *
     142 * @param ptr   Place to store pointer to new string.
     143 */
    114144int os_input_line(char **ptr)
    115145{
    … …  
    126156}
    127157
    128 /** Simple command execution. */
     158/** Simple command execution.
     159 *
     160 * @param cmd   Command and arguments (NULL-terminated list of strings.)
     161 *              Command is present just one, not duplicated.
     162 */
    129163int os_exec(char *const cmd[])
    130164{
    … …  
    157191}
    158192
    159 /** Store the executable file path via which we were executed. */
     193/** Store the executable file path via which we were executed.
     194 *
     195 * @param path  Executable path via which we were executed.
     196 */
    160197void os_store_ef_path(char *path)
    161198{
Note: See TracChangeset for help on using the changeset viewer.