Changeset cde999a in mainline for uspace/drv/nic


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/nic
Files:
8 edited

Legend:

Unmodified
Added
Removed
  • 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,
Note: See TracChangeset for help on using the changeset viewer.