Changeset cde999a in mainline for uspace/drv


Ignore:
Timestamp:
2018-01-04T20:22:51Z (8 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/drv
Files:
20 edited

Legend:

Unmodified
Added
Removed

  • uspace/drv/block/ata_bd/main.c

    r3c7702c0 rcde999a  
    106106 *
    107107 * @param  dev New device
    108  * @return     EOK on success or negative error code.
     108 * @return     EOK on success or an error code.
    109109 */
    110110static int ata_dev_add(ddf_dev_t *dev)

  • uspace/drv/block/ddisk/ddisk.c

    r3c7702c0 rcde999a  
    408408 *
    409409 * @param  dev New device
    410  * @return     EOK on success or negative error code.
     410 * @return     EOK on success or an error code.
    411411 */
    412412static int ddisk_dev_add(ddf_dev_t *dev)

  • uspace/drv/block/usbmast/main.c

    r3c7702c0 rcde999a  
    216216 * @param mdev          Mass storage device
    217217 * @param lun           LUN
    218  * @return              EOK on success or negative error code.
     218 * @return              EOK on success or an error code.
    219219 */
    220220static int usbmast_fun_create(usbmast_dev_t *mdev, unsigned lun)

  • uspace/drv/char/ns8250/ns8250.c

    r3c7702c0 rcde999a  
    405405 *
    406406 * @param ns            Serial port device
    407  * @return              Zero on success, negative error number otherwise
     407 * @return              Zero on success, error number otherwise
    408408 */
    409409static int ns8250_dev_initialize(ns8250_t *ns)
    … …  
    499499 *
    500500 * @param ns            Serial port device
    501  * @return              Zero on success, negative error number otherwise
     501 * @return              Zero on success, error number otherwise
    502502 */
    503503static int ns8250_interrupt_enable(ns8250_t *ns)
    … …  
    544544 * @param port          The base address of the serial port device's ports.
    545545 * @param baud_rate     The baud rate to be used by the device.
    546  * @return              Zero on success, negative error number otherwise (EINVAL
     546 * @return              Zero on success, error number otherwise (EINVAL
    547547 *                      if the specified baud_rate is not valid).
    548548 */

  • uspace/drv/nic/ar9271/ar9271.c

    r3c7702c0 rcde999a  
    734734 * @param ar9271 AR9271 device structure
    735735 *
    736  * @return EOK if succeed, negative error code otherwise
     736 * @return EOK if succeed, error code otherwise
    737737 *
    738738 */
    … …  
    877877 * @param dev The device structure.
    878878 *
    879  * @return EOK if succeed, negative error code otherwise
     879 * @return EOK if succeed, error code otherwise
    880880 */
    881881static int ar9271_add_device(ddf_dev_t *dev)

  • uspace/drv/nic/ar9271/ath_usb.c

    r3c7702c0 rcde999a  
    5656 * @param usb_device  Connected USB device.
    5757 *
    58  * @return EOK if succeed, negative error code otherwise.
     58 * @return EOK if succeed, error code otherwise.
    5959 *
    6060 */
    … …  
    9191 * @param buffer_size Buffer size.
    9292 *
    93  * @return EOK if succeed, negative error code otherwise.
     93 * @return EOK if succeed, error code otherwise.
    9494 *
    9595 */
    … …  
    111111 * @param transferred_size Real size of read data.
    112112 *
    113  * @return EOK if succeed, negative error code otherwise.
     113 * @return EOK if succeed, error code otherwise.
    114114 *
    115115 */
    … …  
    130130 * @param buffer_size Buffer size.
    131131 *
    132  * @return EOK if succeed, negative error code otherwise.
     132 * @return EOK if succeed, error code otherwise.
    133133 *
    134134 */
    … …  
    166166 * @param transferred_size Real size of read data.
    167167 *
    168  * @return EOK if succeed, negative error code otherwise.
     168 * @return EOK if succeed, error code otherwise.
    169169 *
    170170 */

  • uspace/drv/nic/ar9271/htc.c

    r3c7702c0 rcde999a  
    150150 * @param endpoint_id Destination endpoint.
    151151 *
    152  * @return EOK if succeed, negative error code otherwise.
     152 * @return EOK if succeed, error code otherwise.
    153153 *
    154154 */
    … …  
    173173 * @param endpoint_id Destination endpoint.
    174174 *
    175  * @return EOK if succeed, negative error code otherwise.
     175 * @return EOK if succeed, error code otherwise.
    176176 *
    177177 */
    … …  
    196196 * @param transferred_size Real size of read data.
    197197 *
    198  * @return EOK if succeed, negative error code otherwise.
     198 * @return EOK if succeed, error code otherwise.
    199199 *
    200200 */
    … …  
    216216 * @param transferred_size Real size of read data.
    217217 *
    218  * @return EOK if succeed, negative error code otherwise.
     218 * @return EOK if succeed, error code otherwise.
    219219 *
    220220 */
    … …  
    236236 *
    237237 * @return EOK if succeed, EINVAL when failed to connect service,
    238  *         negative error code otherwise.
     238 *         error code otherwise.
    239239 *
    240240 */
    … …  
    309309 * @param htc_device HTC device structure.
    310310 *
    311  * @return EOK if succeed, negative error code otherwise.
     311 * @return EOK if succeed, error code otherwise.
    312312 *
    313313 */
    … …  
    357357 * @param htc_device HTC device structure.
    358358 *
    359  * @return EOK if succeed, negative error code otherwise.
     359 * @return EOK if succeed, error code otherwise.
    360360 *
    361361 */
    … …  
    391391 *
    392392 * @return EOK if succeed, EINVAL if response error,
    393  *         negative error code otherwise.
     393 *         error code otherwise.
    394394 *
    395395 */
    … …  
    427427 * @param htc_device HTC device structure to be initialized.
    428428 *
    429  * @return EOK if succeed, negative error code otherwise.
     429 * @return EOK if succeed, error code otherwise.
    430430 *
    431431 */
    … …  
    448448 * @param htc_device HTC device structure.
    449449 *
    450  * @return EOK if succeed, negative error code otherwise.
     450 * @return EOK if succeed, error code otherwise.
    451451 *
    452452 */

  • uspace/drv/nic/ar9271/hw.c

    r3c7702c0 rcde999a  
    4949 *
    5050 * @return EOK if succeed, ETIMEOUT on timeout,
    51  *         negative error code otherwise.
     51 *         error code otherwise.
    5252 *
    5353 */
    … …  
    215215 * @param ar9271 Device structure.
    216216 *
    217  * @return EOK if succeed, negative error code otherwise.
     217 * @return EOK if succeed, error code otherwise.
    218218 *
    219219 */
    … …  
    636636 * @param ar9271 Device structure.
    637637 *
    638  * @return EOK if succeed, negative error code otherwise.
     638 * @return EOK if succeed, error code otherwise.
    639639 */
    640640int hw_init(ar9271_t *ar9271)

  • uspace/drv/nic/ar9271/wmi.c

    r3c7702c0 rcde999a  
    4747 * @param res        Stored result.
    4848 *
    49  * @return EOK if succeed, negative error code otherwise.
     49 * @return EOK if succeed, error code otherwise.
    5050 *
    5151 */
    … …  
    7979 * @param val        Value to be written
    8080 *
    81  * @return EOK if succeed, negative error code otherwise.
     81 * @return EOK if succeed, error code otherwise.
    8282 *
    8383 */
    … …  
    112112 * @param clear_bit  Bit to be cleared.
    113113 *
    114  * @return EOK if succeed, negative error code otherwise.
     114 * @return EOK if succeed, error code otherwise.
    115115 *
    116116 */
    … …  
    146146 * @param set_bit    Bit to be set.
    147147 *
    148  * @return EOK if succeed, negative error code otherwise.
     148 * @return EOK if succeed, error code otherwise.
    149149 *
    150150 */
    … …  
    161161 * @param clear_bit  Bit to be cleared.
    162162 *
    163  * @return EOK if succeed, negative error code otherwise.
     163 * @return EOK if succeed, error code otherwise.
    164164 *
    165165 */
    … …  
    176176 * @param elements   Number of elements in array.
    177177 *
    178  * @return EOK if succeed, negative error code otherwise.
     178 * @return EOK if succeed, error code otherwise.
    179179 *
    180180 */
    … …  
    220220 * @param response_buffer Buffer with response data.
    221221 *
    222  * @return EOK if succeed, negative error code otherwise.
     222 * @return EOK if succeed, error code otherwise.
    223223 *
    224224 */

  • uspace/drv/nic/e1k/e1k.c

    r3c7702c0 rcde999a  
    12611261 * @param[out] handle  IRQ capability handle if the handler was registered
    12621262 *
    1263  * @return Negative error code otherwise
     1263 * @return An error code otherwise
    12641264 *
    12651265 */
    … …  
    13701370 *
    13711371 * @return EOK if succeed
    1372  * @return Negative error code otherwise
     1372 * @return An error code otherwise
    13731373 *
    13741374 */
    … …  
    15241524 *
    15251525 * @return EOK if succeed
    1526  * @return Negative error code otherwise
     1526 * @return An error code otherwise
    15271527 *
    15281528 */
    … …  
    19401940 *
    19411941 * @return EOK if succeed
    1942  * @return Negative error code otherwise
     1942 * @return An error code otherwise
    19431943 *
    19441944 */
    … …  
    19651965 *
    19661966 * @return EOK if succeed
    1967  * @return Negative error code otherwise
     1967 * @return An error code otherwise
    19681968 *
    19691969 */
    … …  
    19931993 *
    19941994 * @return EOK if succeed
    1995  * @return Negative error code otherwise
     1995 * @return An error code otherwise
    19961996 *
    19971997 */
    … …  
    21072107 *
    21082108 * @return EOK if successed
    2109  * @return Negative error code otherwise
     2109 * @return An error code otherwise
    21102110 *
    21112111 */
    … …  
    22552255 *
    22562256 * @return EOK if succeed
    2257  * @return Negative error code otherwise
     2257 * @return An error code otherwise
    22582258 *
    22592259 */
    … …  
    22892289 *
    22902290 * @return EOK if succeed
    2291  * @return Negative error code otherwise
     2291 * @return An error code otherwise
    22922292 */
    22932293static int e1000_set_addr(ddf_fun_t *fun, const nic_address_t *addr)

  • uspace/drv/nic/rtl8139/driver.c

    r3c7702c0 rcde999a  
    217217 *  @param address  The place to store the address
    218218 *
    219  *  @return EOK if succeed, negative error code otherwise
     219 *  @return EOK if succeed, error code otherwise
    220220 */
    221221inline static void rtl8139_hw_get_addr(rtl8139_t *rtl8139,
    … …  
    844844 *  @param[out] handle  IRQ capability handle if the handler was registered.
    845845 *
    846  *  @return Negative error code otherwise.
     846 *  @return An error code otherwise.
    847847 */
    848848inline static int rtl8139_register_int_handler(nic_t *nic_data, cap_handle_t *handle)
    … …  
    10251025 *  @param hw_resources  Devices hardware resources
    10261026 *
    1027  *  @return EOK if succeed, negative error code otherwise
     1027 *  @return EOK if succeed, error code otherwise
    10281028 */
    10291029static int rtl8139_fill_resource_info(ddf_dev_t *dev, const hw_res_list_parsed_t
    … …  
    10651065 *  @param dev  The device structure
    10661066 *
    1067  *  @return EOK if succeed, negative error code otherwise
     1067 *  @return EOK if succeed, error code otherwise
    10681068 */
    10691069static int rtl8139_get_resource_info(ddf_dev_t *dev)
    … …  
    11471147 *  @param dev  The device information
    11481148 *
    1149  *  @return EOK if succeed, negative error code otherwise
     1149 *  @return EOK if succeed, error code otherwise
    11501150 */
    11511151static int rtl8139_device_initialize(ddf_dev_t *dev)
    … …  
    12061206 * @param dev  The RTL8139 device.
    12071207 *
    1208  * @return EOK if successed, negative error code otherwise
     1208 * @return EOK if successed, error code otherwise
    12091209 */
    12101210static int rtl8139_pio_enable(ddf_dev_t *dev)
    … …  
    12561256 * @param dev  The RTL8139 device.
    12571257 *
    1258  * @return EOK if added successfully, negative error code otherwise
     1258 * @return EOK if added successfully, error code otherwise
    12591259 */
    12601260int rtl8139_dev_add(ddf_dev_t *dev)
    … …  
    13391339 *  @param max_len  Maximal addresss length to store
    13401340 *
    1341  *  @return EOK if succeed, negative error code otherwise
     1341 *  @return EOK if succeed, error code otherwise
    13421342 */
    13431343static int rtl8139_set_addr(ddf_fun_t *fun, const nic_address_t *addr)

  • uspace/drv/nic/rtl8139/general.c

    r3c7702c0 rcde999a  
    8181 *  @param time        The requested time
    8282 *
    83  *  @return EOK if succeed, negative error code otherwise
     83 *  @return EOK if succeed, error code otherwise
    8484 */
    8585int rtl8139_timer_act_init(rtl8139_timer_act_t * ta, uint32_t timer_freq,

  • uspace/drv/platform/amdm37x/main.c

    r3c7702c0 rcde999a  
    209209 *            (both of HW and pseudo devices).
    210210 *
    211  * @return Zero on success, negative error number otherwise.
     211 * @return Zero on success, error number otherwise.
    212212 *
    213213 */

  • uspace/drv/platform/mac/mac.c

    r3c7702c0 rcde999a  
    173173 *            (both of HW and pseudo devices).
    174174 *
    175  * @return Zero on success, negative error number otherwise.
     175 * @return Zero on success, error number otherwise.
    176176 *
    177177 */

  • uspace/drv/platform/malta/malta.c

    r3c7702c0 rcde999a  
    221221 * @param dev           The device which is root of the whole device tree (both
    222222 *                      of HW and pseudo devices).
    223  * @return              Zero on success, negative error number otherwise.
     223 * @return              Zero on success, error number otherwise.
    224224 */
    225225static int malta_dev_add(ddf_dev_t *dev)

  • uspace/drv/platform/pc/pc.c

    r3c7702c0 rcde999a  
    203203 * @param dev           The device which is root of the whole device tree (both
    204204 *                      of HW and pseudo devices).
    205  * @return              Zero on success, negative error number otherwise.
     205 * @return              Zero on success, error number otherwise.
    206206 */
    207207static int pc_dev_add(ddf_dev_t *dev)

  • uspace/drv/platform/sun4u/sun4u.c

    r3c7702c0 rcde999a  
    240240 * @param dev           The device which is root of the whole device tree (both
    241241 *                      of HW and pseudo devices).
    242  * @return              Zero on success, negative error number otherwise.
     242 * @return              Zero on success, error number otherwise.
    243243 */
    244244static int sun4u_dev_add(ddf_dev_t *dev)

  • uspace/drv/root/root/root.c

    r3c7702c0 rcde999a  
    8484 *
    8585 * @param dev   Device
    86  * @return      EOK on success or negative error code
     86 * @return      EOK on success or an error code
    8787 */
    8888static int add_virtual_root_fun(ddf_dev_t *dev)
    … …  
    125125 *
    126126 * @param dev   Device
    127  * @return      EOK on success or negative error code
     127 * @return      EOK on success or an error code
    128128 */
    129129static int add_platform_fun(ddf_dev_t *dev)

  • uspace/drv/root/virt/virt.c

    r3c7702c0 rcde999a  
    9898 * @param vdev          The virtual device
    9999 * @param vfun          Virtual function description
    100  * @return              EOK on success or negative error code.
     100 * @return              EOK on success or an error code.
    101101 */
    102102static int virt_add_fun(virt_t *virt, virtual_function_t *vfun)

  • uspace/drv/time/cmos-rtc/cmos-rtc.c

    r3c7702c0 rcde999a  
    190190 * @param rtc  Pointer to the RTC device
    191191 *
    192  * @return  EOK on success or a negative error code
     192 * @return  EOK on success or an error code
    193193 */
    194194static int
    … …  
    314314 * @param t    Pointer to the time variable
    315315 *
    316  * @return  EOK on success or a negative error code
     316 * @return  EOK on success or an error code
    317317 */
    318318static int
    … …  
    436436 * @param t    The time value to set
    437437 *
    438  * @return  EOK or a negative error code
     438 * @return  EOK or an error code
    439439 */
    440440static int
    … …  
    544544 * @param status The status of the battery
    545545 *
    546  * @return       EOK on success or a negative error code
     546 * @return       EOK on success or an error code
    547547 */
    548548static int
    … …  
    577577 * @param dev  The RTC device
    578578 *
    579  * @return  EOK on success or a negative error code
     579 * @return  EOK on success or an error code
    580580 */
    581581static int
    … …  
    643643 * @param dev   The RTC device
    644644 *
    645  * @return      EOK on success or a negative error code
     645 * @return      EOK on success or an error code
    646646 */
    647647static int
    … …  
    682682 * @param fun   The function node
    683683 *
    684  * @return  EOK on success or a negative error code
     684 * @return  EOK on success or an error code
    685685 */
    686686static int
Note: See TracChangeset for help on using the changeset viewer.