Changeset cde999a in mainline for uspace/lib/c


Ignore:
Timestamp:
2018-01-04T20:22:51Z (7 years ago)
Author:
Jiří Zárevúcky <zarevucky.jiri@…>
Branches:
lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export
Children:
3d95c9d, 84a1a54
Parents:
3c7702c0
git-author:
Jiří Zárevúcky <zarevucky.jiri@…> (2018-01-04 19:18:29)
git-committer:
Jiří Zárevúcky <zarevucky.jiri@…> (2018-01-04 20:22:51)
Message:

Fix comments to stop referring to error codes as negative.

Location:
uspace/lib/c/generic
Files:
19 edited

Legend:

Unmodified
Added
Removed

  • uspace/lib/c/generic/async.c

    r3c7702c0 rcde999a  
    844844 * @param port_id ID of the newly created port.
    845845 *
    846  * @return Zero on success or a negative error code.
     846 * @return Zero on success or an error code.
    847847 *
    848848 */
    … …  
    10531053 * @param[out] handle  IRQ capability handle on success.
    10541054 *
    1055  * @return Negative error code.
     1055 * @return An error code.
    10561056 *
    10571057 */
    … …  
    10891089 * @param cap     IRQ capability handle.
    10901090 *
    1091  * @return Zero on success or a negative error code.
     1091 * @return Zero on success or an error code.
    10921092 *
    10931093 */
    … …  
    11061106 * @param data    Notification handler client data.
    11071107 *
    1108  * @return Zero on success or a negative error code.
     1108 * @return Zero on success or an error code.
    11091109 *
    11101110 */
    … …  
    11391139 * @param data    Notification handler client data.
    11401140 *
    1141  * @return Zero on success or a negative error code.
     1141 * @return Zero on success or an error code.
    11421142 *
    11431143 */
    … …  
    19151915 * @param r5      If non-NULL, storage for the 5th reply argument.
    19161916 *
    1917  * @return Return code of the reply or a negative error code.
     1917 * @return Return code of the reply or an error code.
    19181918 *
    19191919 */
    … …  
    19671967 * @param r5      If non-NULL, storage for the 5th reply argument.
    19681968 *
    1969  * @return Return code of the reply or a negative error code.
     1969 * @return Return code of the reply or an error code.
    19701970 *
    19711971 */
    … …  
    21082108 * @param arg3            User defined argument.
    21092109 *
    2110  * @return Zero on success or a negative error code.
     2110 * @return Zero on success or an error code.
    21112111 *
    21122112 */
    … …  
    24332433 * @param sess Session to hung up.
    24342434 *
    2435  * @return Zero on success or a negative error code.
     2435 * @return Zero on success or an error code.
    24362436 *
    24372437 */
    … …  
    26132613 *              base address. Cannot be NULL.
    26142614 *
    2615  * @return Zero on success or a negative error code from errno.h.
     2615 * @return Zero on success or an error code from errno.h.
    26162616 *
    26172617 */
    … …  
    26882688 * @param flags Flags to be used for sharing. Bits can be only cleared.
    26892689 *
    2690  * @return Zero on success or a negative error code from errno.h.
     2690 * @return Zero on success or an error code from errno.h.
    26912691 *
    26922692 */
    … …  
    27742774 * @param size Size of the destination buffer.
    27752775 *
    2776  * @return Zero on success or a negative error code from errno.h.
     2776 * @return Zero on success or an error code from errno.h.
    27772777 *
    27782778 */
    … …  
    28992899 * @param size Size of the source buffer.
    29002900 *
    2901  * @return Zero on success or a negative error code from errno.h.
     2901 * @return Zero on success or an error code from errno.h.
    29022902 *
    29032903 */

  • uspace/lib/c/generic/clipboard.c

    r3c7702c0 rcde999a  
    9595 * @param str String to put to clipboard or NULL.
    9696 *
    97  * @return Zero on success or negative error code.
     97 * @return Zero on success or an error code.
    9898 *
    9999 */
    … …  
    137137 * @param str Here pointer to the newly allocated string is stored.
    138138 *
    139  * @return Zero on success or negative error code.
     139 * @return Zero on success or an error code.
    140140 *
    141141 */

  • uspace/lib/c/generic/ddi.c

    r3c7702c0 rcde999a  
    226226 *
    227227 * @return EOK on success.
    228  * @return Negative error code on failure.
     228 * @return An error code on failure.
    229229 *
    230230 */
    … …  
    268268 *
    269269 * @return EOK on success.
    270  * @return Negative error code on failure.
     270 * @return An error code on failure.
    271271 *
    272272 */
    … …  
    306306 *
    307307 * @return EOK on success.
    308  * @return Negative error code on failure.
     308 * @return An error code on failure.
    309309 *
    310310 */

  • uspace/lib/c/generic/device/clock_dev.c

    r3c7702c0 rcde999a  
    4444 * @param t        The current time that will be read from the device
    4545 *
    46  * @return         EOK on success or a negative error code
     46 * @return         EOK on success or an error code
    4747 */
    4848int
    … …  
    7575 * @param t      The current time that will be written to the device
    7676 *
    77  * @return       EOK on success or a negative error code
     77 * @return       EOK on success or an error code
    7878 */
    7979int

  • uspace/lib/c/generic/devman.c

    r3c7702c0 rcde999a  
    210210 * @param funh      Place to store handle of the new function
    211211 *
    212  * @return EOK on success or negative error code.
     212 * @return EOK on success or an error code.
    213213 *
    214214 */
    … …  
    305305 * @param funh      Devman handle of the function
    306306 *
    307  * @return EOK on success or negative error code.
     307 * @return EOK on success or an error code.
    308308 */
    309309int devman_remove_function(devman_handle_t funh)
    … …  
    529529 * @param data          Place to store pointer to array of handles
    530530 * @param count         Place to store number of handles
    531  * @return              EOK on success or negative error code
     531 * @return              EOK on success or an error code
    532532 */
    533533static int devman_get_handles_internal(sysarg_t method, sysarg_t arg1,

  • uspace/lib/c/generic/inet/tcp.c

    r3c7702c0 rcde999a  
    5959 *
    6060 * @param tcp TCP service
    61  * @return EOK on success or negative error code
     61 * @return EOK on success or an error code
    6262 */
    6363static int tcp_callback_create(tcp_t *tcp)
    … …  
    205205 * @param rconn Place to store pointer to new connection
    206206 *
    207  * @return EOK on success or negative error code.
     207 * @return EOK on success or an error code.
    208208 */
    209209int tcp_conn_create(tcp_t *tcp, inet_ep2_t *epp, tcp_cb_t *cb, void *arg,
    … …  
    316316 * @param rlst Place to store pointer to new listener
    317317 *
    318  * @return EOK on success or negative error code
     318 * @return EOK on success or an error code
    319319 */
    320320int tcp_listener_create(tcp_t *tcp, inet_ep_t *ep, tcp_listen_cb_t *lcb,
    … …  
    446446 * @param bytes Data size in bytes
    447447 *
    448  * @return EOK on success or negative error code
     448 * @return EOK on success or an error code
    449449 */
    450450int tcp_conn_send(tcp_conn_t *conn, const void *data, size_t bytes)
    … …  
    478478 *
    479479 * @param conn Connection
    480  * @return EOK on success or negative error code
     480 * @return EOK on success or an error code
    481481 */
    482482int tcp_conn_send_fin(tcp_conn_t *conn)
    … …  
    494494 *
    495495 * @param conn Connection
    496  * @return EOK on success or negative error code
     496 * @return EOK on success or an error code
    497497 */
    498498int tcp_conn_push(tcp_conn_t *conn)
    … …  
    510510 *
    511511 * @param conn Connection
    512  * @return EOK on success or negative error code
     512 * @return EOK on success or an error code
    513513 */
    514514int tcp_conn_reset(tcp_conn_t *conn)
    … …  
    538538 *
    539539 * @return EOK on success, EAGAIN if no received data is pending, or other
    540  *         negative error code in case of other error
     540 *         error code in case of other error
    541541 */
    542542int tcp_conn_recv(tcp_conn_t *conn, void *buf, size_t bsize, size_t *nrecv)
    … …  
    586586 * @param nrecv Place to store actual number of received bytes
    587587 *
    588  * @return EOK on success or negative error code
     588 * @return EOK on success or an error code
    589589 */
    590590int tcp_conn_recv_wait(tcp_conn_t *conn, void *buf, size_t bsize,

  • uspace/lib/c/generic/inet/udp.c

    r3c7702c0 rcde999a  
    4646 *
    4747 * @param udp UDP service
    48  * @return EOK on success or negative error code
     48 * @return EOK on success or an error code
    4949 */
    5050static int udp_callback_create(udp_t *udp)
    … …  
    158158 * @param rassoc Place to store pointer to new association
    159159 *
    160  * @return EOK on success or negative error code.
     160 * @return EOK on success or an error code.
    161161 */
    162162int udp_assoc_create(udp_t *udp, inet_ep2_t *epp, udp_cb_t *cb, void *arg,
    … …  
    250250 * @param bytes Message size in bytes
    251251 *
    252  * @return EOK on success or negative error code
     252 * @return EOK on success or an error code
    253253 */
    254254int udp_assoc_send_msg(udp_assoc_t *assoc, inet_ep_t *dest, void *data,
    … …  
    316316 * @param bsize Buffer size
    317317 *
    318  * @return EOK on success or negative error code.
     318 * @return EOK on success or an error code.
    319319 */
    320320int udp_rmsg_read(udp_rmsg_t *rmsg, size_t off, void *buf, size_t bsize)
    … …  
    380380 * @param rmsg Place to store message information
    381381 *
    382  * @return EOK on success or negative error code
     382 * @return EOK on success or an error code
    383383 */
    384384static int udp_rmsg_info(udp_t *udp, udp_rmsg_t *rmsg)
    … …  
    413413 *
    414414 * @param udp UDP client
    415  * @return EOK on success or negative error code
     415 * @return EOK on success or an error code
    416416 */
    417417static int udp_rmsg_discard(udp_t *udp)

  • uspace/lib/c/generic/inetcfg.c

    r3c7702c0 rcde999a  
    7474 * @param data          Place to store pointer to array of IDs
    7575 * @param count         Place to store number of IDs
    76  * @return              EOK on success or negative error code
     76 * @return              EOK on success or an error code
    7777 */
    7878static int inetcfg_get_ids_internal(sysarg_t method, sysarg_t arg1,

  • uspace/lib/c/generic/io/asprintf.c

    r3c7702c0 rcde999a  
    7979 * @args       Variable argument list
    8080 *
    81  * @return Number of characters printed or a negative error code.
     81 * @return Number of characters printed or an error code.
    8282 *
    8383 */
    … …  
    106106 * @fmt        Format string.
    107107 *
    108  * @return Number of characters printed or a negative error code.
     108 * @return Number of characters printed or an error code.
    109109 *
    110110 */

  • uspace/lib/c/generic/ipc.c

    r3c7702c0 rcde999a  
    325325 * @param phandle  Handle of the phone to be hung up.
    326326 *
    327  * @return  Zero on success or a negative error code.
     327 * @return  Zero on success or an error code.
    328328 *
    329329 */

  • uspace/lib/c/generic/loader.c

    r3c7702c0 rcde999a  
    8484 * @param task_id Points to a variable where the ID should be stored.
    8585 *
    86  * @return Zero on success or negative error code.
     86 * @return Zero on success or an error code.
    8787 *
    8888 */
    … …  
    113113 * @param ldr  Loader connection structure.
    114114 *
    115  * @return Zero on success or negative error code.
     115 * @return Zero on success or an error code.
    116116 *
    117117 */
    … …  
    151151 * @param file Program file.
    152152 *
    153  * @return Zero on success or negative error code.
     153 * @return Zero on success or an error code.
    154154 *
    155155 */
    … …  
    184184 * @param path Program path.
    185185 *
    186  * @return Zero on success or negative error code.
     186 * @return Zero on success or an error code.
    187187 *
    188188 */
    … …  
    217217 * @param argv NULL-terminated array of pointers to arguments.
    218218 *
    219  * @return Zero on success or negative error code.
     219 * @return Zero on success or an error code.
    220220 *
    221221 */
    … …  
    273273 * @param file       The file's descriptor.
    274274 *
    275  * @return Zero on success or negative error code.
     275 * @return Zero on success or an error code.
    276276 *
    277277 */
    … …  
    307307 * @param ldr Loader connection structure.
    308308 *
    309  * @return Zero on success or negative error code.
     309 * @return Zero on success or an error code.
    310310 *
    311311 */
    … …  
    330330 * @param ldr Loader connection structure.
    331331 *
    332  * @return Zero on success or negative error code.
     332 * @return Zero on success or an error code.
    333333 *
    334334 */
    … …  
    356356 * @param ldr Loader connection structure.
    357357 *
    358  * @return Zero on success or negative error code.
     358 * @return Zero on success or an error code.
    359359 *
    360360 */

  • uspace/lib/c/generic/loc.c

    r3c7702c0 rcde999a  
    371371 * @param name          Place to store pointer to new string. Caller should
    372372 *                      free it using free().
    373  * @return              EOK on success or negative error code
     373 * @return              EOK on success or an error code
    374374 */
    375375static int loc_get_name_internal(sysarg_t method, sysarg_t id, char **name)
    … …  
    421421 * @param name          Place to store pointer to new string. Caller should
    422422 *                      free it using free().
    423  * @return              EOK on success or negative error code
     423 * @return              EOK on success or an error code
    424424 */
    425425int loc_category_get_name(category_id_t cat_id, char **name)
    … …  
    435435 * @param name          Place to store pointer to new string. Caller should
    436436 *                      free it using free().
    437  * @return              EOK on success or negative error code
     437 * @return              EOK on success or an error code
    438438 */
    439439int loc_service_get_name(service_id_t svc_id, char **name)
    … …  
    449449 * @param name          Place to store pointer to new string. Caller should
    450450 *                      free it using free().
    451  * @return              EOK on success or negative error code
     451 * @return              EOK on success or an error code
    452452 */
    453453int loc_service_get_server_name(service_id_t svc_id, char **name)
    … …  
    503503 * @param cat_id        Place to store ID
    504504 * @param flags         IPC_FLAG_BLOCKING to wait for location service to start
    505  * @return              EOK on success or negative error code
     505 * @return              EOK on success or an error code
    506506 */
    507507int loc_category_get_id(const char *name, category_id_t *cat_id,
    … …  
    613613 * @param svc_id        Service ID
    614614 * @param cat_id        Category ID
    615  * @return              EOK on success or negative error code
     615 * @return              EOK on success or an error code
    616616 */
    617617int loc_service_add_to_cat(service_id_t svc_id, service_id_t cat_id)
    … …  
    790790 * @param data          Place to store pointer to array of IDs
    791791 * @param count         Place to store number of IDs
    792  * @return              EOK on success or negative error code
     792 * @return              EOK on success or an error code
    793793 */
    794794static int loc_get_ids_internal(sysarg_t method, sysarg_t arg1,
    … …  
    836836 * @param data          Place to store pointer to array of IDs
    837837 * @param count         Place to store number of IDs
    838  * @return              EOK on success or negative error code
     838 * @return              EOK on success or an error code
    839839 */
    840840int loc_category_get_svcs(category_id_t cat_id, service_id_t **data,
    … …  
    851851 * @param data          Place to store pointer to array of IDs
    852852 * @param count         Place to store number of IDs
    853  * @return              EOK on success or negative error code
     853 * @return              EOK on success or an error code
    854854 */
    855855int loc_get_categories(category_id_t **data, size_t *count)

  • uspace/lib/c/generic/str.c

    r3c7702c0 rcde999a  
    918918 * @param src   Source utf16 string.
    919919 *
    920  * @return EOK, if success, negative otherwise.
     920 * @return EOK, if success, an error code otherwise.
    921921 */
    922922int utf16_to_str(char *dest, size_t size, const uint16_t *src)
    … …  
    961961 * @param src   Source string.
    962962 *
    963  * @return EOK, if success, negative otherwise.
     963 * @return EOK, if success, an error code otherwise.
    964964 */
    965965int str_to_utf16(uint16_t *dest, size_t dlen, const char *src)

  • uspace/lib/c/generic/task.c

    r3c7702c0 rcde999a  
    6969 *             program.
    7070 *
    71  * @return Zero on success or negative error code.
     71 * @return Zero on success or an error code.
    7272 */
    7373int task_set_name(const char *name)
    … …  
    8282 * @param task_id ID of task to kill.
    8383 *
    84  * @return Zero on success or negative error code.
     84 * @return Zero on success or an error code.
    8585 */
    8686
    … …  
    101101 * @param argv Command-line arguments.
    102102 *
    103  * @return Zero on success or negative error code.
     103 * @return Zero on success or an error code.
    104104 *
    105105 */
    … …  
    143143 * @param std_err File to use as stderr.
    144144 *
    145  * @return Zero on success or negative error code.
     145 * @return Zero on success or an error code.
    146146 *
    147147 */
    … …  
    249249 * @param ap   Command-line arguments.
    250250 *
    251  * @return Zero on success or negative error code.
     251 * @return Zero on success or an error code.
    252252 *
    253253 */
    … …  
    287287 * @param ...  Command-line arguments.
    288288 *
    289  * @return Zero on success or negative error code.
     289 * @return Zero on success or an error code.
    290290 *
    291291 */

  • uspace/lib/c/generic/time.c

    r3c7702c0 rcde999a  
    954954 * @param result Structure to store the result to
    955955 *
    956  * @return EOK or a negative error code
     956 * @return EOK or an error code
    957957 *
    958958 */
    … …  
    984984 *             ASCTIME_BUF_LEN bytes long.
    985985 *
    986  * @return EOK or a negative error code.
     986 * @return EOK or an error code.
    987987 *
    988988 */
    … …  
    10361036 * @param result Structure to store the result to.
    10371037 *
    1038  * @return EOK on success or a negative error code.
     1038 * @return EOK on success or an error code.
    10391039 *
    10401040 */
    … …  
    10661066 * @param result Structure to store the result to.
    10671067 *
    1068  * @return EOK on success or a negative error code.
     1068 * @return EOK on success or an error code.
    10691069 *
    10701070 */
    … …  
    10881088 *              ASCTIME_BUF_LEN bytes long.
    10891089 *
    1090  * @return EOK on success or a negative error code.
     1090 * @return EOK on success or an error code.
    10911091 *
    10921092 */

  • uspace/lib/c/generic/uuid.c

    r3c7702c0 rcde999a  
    4343 *
    4444 * @param uuid Place to store generated UUID
    45  * @return EOK on success or negative error code
     45 * @return EOK on success or an error code
    4646 */
    4747int uuid_generate(uuid_t *uuid)
    … …  
    100100 * @param endptr Place to store pointer to end of UUID or @c NULL
    101101 *
    102  * @return EOK on success or negative error code
     102 * @return EOK on success or an error code
    103103 */
    104104int uuid_parse(const char *str, uuid_t *uuid, const char **endptr)

  • uspace/lib/c/generic/vbd.c

    r3c7702c0 rcde999a  
    9595 * @param count Place to store length of array (number of entries)
    9696 *
    97  * @return EOK on success or negative error code
     97 * @return EOK on success or an error code
    9898 */
    9999int vbd_get_disks(vbd_t *vbd, service_id_t **data, size_t *count)
    … …  
    165165 * @param act_size Place to store actual size of complete data.
    166166 *
    167  * @return EOK on success or negative error code.
     167 * @return EOK on success or an error code.
    168168 */
    169169static int vbd_get_ids_once(vbd_t *vbd, sysarg_t method, sysarg_t arg1,
    … …  
    203203 * @param data   Place to store pointer to array of IDs
    204204 * @param count  Place to store number of IDs
    205  * @return       EOK on success or negative error code
     205 * @return       EOK on success or an error code
    206206 */
    207207static int vbd_get_ids_internal(vbd_t *vbd, sysarg_t method, sysarg_t arg1,
    … …  
    247247 * @param count Place to store length of array (number of entries)
    248248 *
    249  * @return EOK on success or negative error code
     249 * @return EOK on success or an error code
    250250 */
    251251int vbd_label_get_parts(vbd_t *vbd, service_id_t disk,
    … …  
    332332 * @param ptype Place to store suggested partition type
    333333 *
    334  * @return EOK on success or negative error code
     334 * @return EOK on success or an error code
    335335 */
    336336int vbd_suggest_ptype(vbd_t *vbd, service_id_t disk, label_pcnt_t pcnt,

  • uspace/lib/c/generic/vfs/vfs.c

    r3c7702c0 rcde999a  
    236236 *                      handle will be allocated from high indices
    237237 *
    238  * @return              New file handle on success or a negative error code
     238 * @return              New file handle on success or an error code
    239239 */
    240240int vfs_clone(int file_from, int file_to, bool high, int *handle)
    … …  
    259259 * @param size          Size of @a buf
    260260 *
    261  * @return              EOK on success or a non-negative error code
     261 * @return              EOK on success or a non-error code
    262262 */
    263263int vfs_cwd_get(char *buf, size_t size)
    … …  
    280280 * @param path  Path of the new working directory
    281281 *
    282  * @return      EOK on success or a negative error code
     282 * @return      EOK on success or an error code
    283283 */
    284284int vfs_cwd_set(const char *path)
    … …  
    370370 * @param info    Place to store volume identification information
    371371 *
    372  * @return                      EOK on success or a negative error code
     372 * @return                      EOK on success or an error code
    373373 */
    374374int vfs_fsprobe(const char *fs_name, service_id_t serv,
    … …  
    404404 *        fstypes->fstypes[0..]. To free the list use vfs_fstypes_free().
    405405 *
    406  * @return                      EOK on success or a negative error code
     406 * @return                      EOK on success or an error code
    407407 */
    408408int vfs_fstypes(vfs_fstypes_t *fstypes)
    … …  
    499499 * @param[out] linkedfd If not NULL, will receive a file handle to the linked
    500500 *                      child
    501  * @return              EOK on success or a negative error code
     501 * @return              EOK on success or an error code
    502502 */
    503503int vfs_link(int parent, const char *child, vfs_file_kind_t kind, int *linkedfd)
    … …  
    529529 * @param[out] linkedfd If not NULL, will receive a file handle to the linked
    530530 *                      child
    531  * @return              EOK on success or a negative error code
     531 * @return              EOK on success or an error code
    532532 */
    533533int vfs_link_path(const char *path, vfs_file_kind_t kind, int *linkedfd)
    … …  
    585585 * @param[out] handle Pointer to variable where handle is to be written.
    586586 *
    587  * @return      EOK on success or a negative error code
     587 * @return      EOK on success or an error code
    588588 */
    589589int vfs_lookup_open(const char *path, int flags, int mode, int *handle)
    … …  
    614614 * @param[out] mountedfd        File handle of the mounted root if not NULL
    615615 *
    616  * @return                      EOK on success or a negative error code
     616 * @return                      EOK on success or an error code
    617617 */
    618618int vfs_mount(int mp, const char *fs_name, service_id_t serv, const char *opts,
    … …  
    658658 * @param[in] instance          Instance number of the file system server
    659659 *
    660  * @return                      EOK on success or a negative error code
     660 * @return                      EOK on success or an error code
    661661 */
    662662int vfs_mount_path(const char *mp, const char *fs_name, const char *fqsn,
    … …  
    752752 * @param mode  Mode in which to open file in
    753753 *
    754  * @return      EOK on success or a negative error code
     754 * @return      EOK on success or an error code
    755755 */
    756756int vfs_open(int file, int mode)
    … …  
    769769 * @param exch          Exchange to the acceptor
    770770 *
    771  * @return              EOK on success or a negative error code
     771 * @return              EOK on success or an error code
    772772 */
    773773int vfs_pass_handle(async_exch_t *vfs_exch, int file, async_exch_t *exch)
    … …  
    781781 * @param file  File handle to put
    782782 *
    783  * @return      EOK on success or a negative error code
     783 * @return      EOK on success or an error code
    784784 */
    785785int vfs_put(int file)
    … …  
    798798 * @param[out] handle  Received handle.
    799799 *
    800  * @return       EOK on success or a negative error code
     800 * @return       EOK on success or an error code
    801801 */
    802802int vfs_receive_handle(bool high, int *handle)
    … …  
    877877 * @param[out] nread    Actual number of bytes read (0 or more)
    878878 *
    879  * @return              EOK on success or a negative error code
     879 * @return              EOK on success or an error code
    880880 */
    881881int vfs_read_short(int file, aoff64_t pos, void *buf, size_t nbyte,
    … …  
    919919 * @param new   New path
    920920 *
    921  * @return      EOK on success or a negative error code
     921 * @return      EOK on success or an error code
    922922 */
    923923int vfs_rename_path(const char *old, const char *new)
    … …  
    986986 * @param length        New length
    987987 *
    988  * @return              EOK on success or a negative error code
     988 * @return              EOK on success or an error code
    989989 */
    990990int vfs_resize(int file, aoff64_t length)
    … …  
    10501050 * @param[out] stat     Place to store file information
    10511051 *
    1052  * @return              EOK on success or a negative error code
     1052 * @return              EOK on success or an error code
    10531053 */
    10541054int vfs_stat(int file, struct stat *stat)
    … …  
    10841084 * @param[out] stat     Place to store file information
    10851085 *
    1086  * @return              EOK on success or a negative error code
     1086 * @return              EOK on success or an error code
    10871087 */
    10881088int vfs_stat_path(const char *path, struct stat *stat)
    … …  
    11051105 * @param[out] st       Buffer for storing information
    11061106 *
    1107  * @return              EOK on success or a negative error code
     1107 * @return              EOK on success or an error code
    11081108 */
    11091109int vfs_statfs(int file, struct statfs *st)
    … …  
    11301130 * @param[out] st       Buffer for storing information
    11311131 *
    1132  * @return              EOK on success or a negative error code
     1132 * @return              EOK on success or an error code
    11331133 */
    11341134int vfs_statfs_path(const char *path, struct statfs *st)
    … …  
    11501150 * @param file  File handle to synchronize
    11511151 *
    1152  * @return      EOK on success or a negative error code
     1152 * @return      EOK on success or an error code
    11531153 */
    11541154int vfs_sync(int file)
    … …  
    11721172 * @param expect        File handle of the unlinked child
    11731173 *
    1174  * @return              EOK on success or a negative error code
     1174 * @return              EOK on success or an error code
    11751175 */
    11761176int vfs_unlink(int parent, const char *child, int expect)
    … …  
    12011201 * @param path          Old path to be unlinked
    12021202 *
    1203  * @return              EOK on success or a negative error code
     1203 * @return              EOK on success or an error code
    12041204 */
    12051205int vfs_unlink_path(const char *path)
    … …  
    12301230 * @param mp    File handle representing the mount-point
    12311231 *
    1232  * @return      EOK on success or a negative error code
     1232 * @return      EOK on success or an error code
    12331233 */
    12341234int vfs_unmount(int mp)
    … …  
    12441244 * @param mpp   Mount-point path
    12451245 *
    1246  * @return      EOK on success or a negative error code
     1246 * @return      EOK on success or an error code
    12471247 */
    12481248int vfs_unmount_path(const char *mpp)
    … …  
    13411341 * @param[out] nread    Actual number of bytes written (0 or more)
    13421342 *
    1343  * @return              EOK on success or a negative error code
     1343 * @return              EOK on success or an error code
    13441344 */
    13451345int vfs_write_short(int file, aoff64_t pos, const void *buf, size_t nbyte,

  • uspace/lib/c/generic/vol.c

    r3c7702c0 rcde999a  
    101101 * @param act_size Place to store actual size of complete data.
    102102 *
    103  * @return EOK on success or negative error code.
     103 * @return EOK on success or an error code.
    104104 */
    105105static int vol_get_ids_once(vol_t *vol, sysarg_t method, sysarg_t arg1,
    … …  
    139139 * @param data   Place to store pointer to array of IDs
    140140 * @param count  Place to store number of IDs
    141  * @return       EOK on success or negative error code
     141 * @return       EOK on success or an error code
    142142 */
    143143static int vol_get_ids_internal(vol_t *vol, sysarg_t method, sysarg_t arg1,
    … …  
    183183 * @param count Place to store length of array (number of entries)
    184184 *
    185  * @return EOK on success or negative error code
     185 * @return EOK on success or an error code
    186186 */
    187187int vol_get_parts(vol_t *vol, service_id_t **data, size_t *count)
Note: See TracChangeset for help on using the changeset viewer.