@@ -521,13 +521,13 @@ static void list_add_locked(struct list_head *new, struct list_head *head,
521
521
spin_unlock_irqrestore (lock , flags );
522
522
}
523
523
524
- /**
524
+ /*
525
525
* register a client callback that called when device plugged in/unplugged
526
526
* NOTE: if devices exist callback is called immediately for each device
527
527
*
528
528
* @param hotplug callback
529
529
*
530
- * @ return 0 on success, <0 on error.
530
+ * return: 0 on success, <0 on error.
531
531
*/
532
532
int smscore_register_hotplug (hotplug_t hotplug )
533
533
{
@@ -562,7 +562,7 @@ int smscore_register_hotplug(hotplug_t hotplug)
562
562
}
563
563
EXPORT_SYMBOL_GPL (smscore_register_hotplug );
564
564
565
- /**
565
+ /*
566
566
* unregister a client callback that called when device plugged in/unplugged
567
567
*
568
568
* @param hotplug callback
@@ -636,15 +636,15 @@ smscore_buffer_t *smscore_createbuffer(u8 *buffer, void *common_buffer,
636
636
return cb ;
637
637
}
638
638
639
- /**
639
+ /*
640
640
* creates coredev object for a device, prepares buffers,
641
641
* creates buffer mappings, notifies registered hotplugs about new device.
642
642
*
643
643
* @param params device pointer to struct with device specific parameters
644
644
* and handlers
645
645
* @param coredev pointer to a value that receives created coredev object
646
646
*
647
- * @ return 0 on success, <0 on error.
647
+ * return: 0 on success, <0 on error.
648
648
*/
649
649
int smscore_register_device (struct smsdevice_params_t * params ,
650
650
struct smscore_device_t * * coredev ,
@@ -764,10 +764,10 @@ static int smscore_sendrequest_and_wait(struct smscore_device_t *coredev,
764
764
0 : - ETIME ;
765
765
}
766
766
767
- /**
767
+ /*
768
768
* Starts & enables IR operations
769
769
*
770
- * @ return 0 on success, < 0 on error.
770
+ * return: 0 on success, < 0 on error.
771
771
*/
772
772
static int smscore_init_ir (struct smscore_device_t * coredev )
773
773
{
@@ -812,13 +812,13 @@ static int smscore_init_ir(struct smscore_device_t *coredev)
812
812
return 0 ;
813
813
}
814
814
815
- /**
815
+ /*
816
816
* configures device features according to board configuration structure.
817
817
*
818
818
* @param coredev pointer to a coredev object returned by
819
819
* smscore_register_device
820
820
*
821
- * @ return 0 on success, <0 on error.
821
+ * return: 0 on success, <0 on error.
822
822
*/
823
823
static int smscore_configure_board (struct smscore_device_t * coredev )
824
824
{
@@ -861,13 +861,13 @@ static int smscore_configure_board(struct smscore_device_t *coredev)
861
861
return 0 ;
862
862
}
863
863
864
- /**
864
+ /*
865
865
* sets initial device mode and notifies client hotplugs that device is ready
866
866
*
867
867
* @param coredev pointer to a coredev object returned by
868
868
* smscore_register_device
869
869
*
870
- * @ return 0 on success, <0 on error.
870
+ * return: 0 on success, <0 on error.
871
871
*/
872
872
int smscore_start_device (struct smscore_device_t * coredev )
873
873
{
@@ -1087,7 +1087,7 @@ static char *smscore_fw_lkup[][DEVICE_MODE_MAX] = {
1087
1087
},
1088
1088
};
1089
1089
1090
- /**
1090
+ /*
1091
1091
* get firmware file name from one of the two mechanisms : sms_boards or
1092
1092
* smscore_fw_lkup.
1093
1093
* @param coredev pointer to a coredev object returned by
@@ -1096,7 +1096,7 @@ static char *smscore_fw_lkup[][DEVICE_MODE_MAX] = {
1096
1096
* @param lookup if 1, always get the fw filename from smscore_fw_lkup
1097
1097
* table. if 0, try first to get from sms_boards
1098
1098
*
1099
- * @ return 0 on success, <0 on error.
1099
+ * return: 0 on success, <0 on error.
1100
1100
*/
1101
1101
static char * smscore_get_fw_filename (struct smscore_device_t * coredev ,
1102
1102
int mode )
@@ -1125,15 +1125,15 @@ static char *smscore_get_fw_filename(struct smscore_device_t *coredev,
1125
1125
return fw [mode ];
1126
1126
}
1127
1127
1128
- /**
1128
+ /*
1129
1129
* loads specified firmware into a buffer and calls device loadfirmware_handler
1130
1130
*
1131
1131
* @param coredev pointer to a coredev object returned by
1132
1132
* smscore_register_device
1133
1133
* @param filename null-terminated string specifies firmware file name
1134
1134
* @param loadfirmware_handler device handler that loads firmware
1135
1135
*
1136
- * @ return 0 on success, <0 on error.
1136
+ * return: 0 on success, <0 on error.
1137
1137
*/
1138
1138
static int smscore_load_firmware_from_file (struct smscore_device_t * coredev ,
1139
1139
int mode ,
@@ -1182,14 +1182,14 @@ static int smscore_load_firmware_from_file(struct smscore_device_t *coredev,
1182
1182
return rc ;
1183
1183
}
1184
1184
1185
- /**
1185
+ /*
1186
1186
* notifies all clients registered with the device, notifies hotplugs,
1187
1187
* frees all buffers and coredev object
1188
1188
*
1189
1189
* @param coredev pointer to a coredev object returned by
1190
1190
* smscore_register_device
1191
1191
*
1192
- * @ return 0 on success, <0 on error.
1192
+ * return: 0 on success, <0 on error.
1193
1193
*/
1194
1194
void smscore_unregister_device (struct smscore_device_t * coredev )
1195
1195
{
@@ -1282,14 +1282,14 @@ static int smscore_detect_mode(struct smscore_device_t *coredev)
1282
1282
return rc ;
1283
1283
}
1284
1284
1285
- /**
1285
+ /*
1286
1286
* send init device request and wait for response
1287
1287
*
1288
1288
* @param coredev pointer to a coredev object returned by
1289
1289
* smscore_register_device
1290
1290
* @param mode requested mode of operation
1291
1291
*
1292
- * @ return 0 on success, <0 on error.
1292
+ * return: 0 on success, <0 on error.
1293
1293
*/
1294
1294
static int smscore_init_device (struct smscore_device_t * coredev , int mode )
1295
1295
{
@@ -1315,15 +1315,15 @@ static int smscore_init_device(struct smscore_device_t *coredev, int mode)
1315
1315
return rc ;
1316
1316
}
1317
1317
1318
- /**
1318
+ /*
1319
1319
* calls device handler to change mode of operation
1320
1320
* NOTE: stellar/usb may disconnect when changing mode
1321
1321
*
1322
1322
* @param coredev pointer to a coredev object returned by
1323
1323
* smscore_register_device
1324
1324
* @param mode requested mode of operation
1325
1325
*
1326
- * @ return 0 on success, <0 on error.
1326
+ * return: 0 on success, <0 on error.
1327
1327
*/
1328
1328
int smscore_set_device_mode (struct smscore_device_t * coredev , int mode )
1329
1329
{
@@ -1411,21 +1411,21 @@ int smscore_set_device_mode(struct smscore_device_t *coredev, int mode)
1411
1411
return rc ;
1412
1412
}
1413
1413
1414
- /**
1414
+ /*
1415
1415
* calls device handler to get current mode of operation
1416
1416
*
1417
1417
* @param coredev pointer to a coredev object returned by
1418
1418
* smscore_register_device
1419
1419
*
1420
- * @ return current mode
1420
+ * return: current mode
1421
1421
*/
1422
1422
int smscore_get_device_mode (struct smscore_device_t * coredev )
1423
1423
{
1424
1424
return coredev -> mode ;
1425
1425
}
1426
1426
EXPORT_SYMBOL_GPL (smscore_get_device_mode );
1427
1427
1428
- /**
1428
+ /*
1429
1429
* find client by response id & type within the clients list.
1430
1430
* return client handle or NULL.
1431
1431
*
@@ -1462,7 +1462,7 @@ smscore_client_t *smscore_find_client(struct smscore_device_t *coredev,
1462
1462
return client ;
1463
1463
}
1464
1464
1465
- /**
1465
+ /*
1466
1466
* find client by response id/type, call clients onresponse handler
1467
1467
* return buffer to pool on error
1468
1468
*
@@ -1615,13 +1615,13 @@ void smscore_onresponse(struct smscore_device_t *coredev,
1615
1615
}
1616
1616
EXPORT_SYMBOL_GPL (smscore_onresponse );
1617
1617
1618
- /**
1618
+ /*
1619
1619
* return pointer to next free buffer descriptor from core pool
1620
1620
*
1621
1621
* @param coredev pointer to a coredev object returned by
1622
1622
* smscore_register_device
1623
1623
*
1624
- * @ return pointer to descriptor on success, NULL on error.
1624
+ * return: pointer to descriptor on success, NULL on error.
1625
1625
*/
1626
1626
1627
1627
static struct smscore_buffer_t * get_entry (struct smscore_device_t * coredev )
@@ -1648,7 +1648,7 @@ struct smscore_buffer_t *smscore_getbuffer(struct smscore_device_t *coredev)
1648
1648
}
1649
1649
EXPORT_SYMBOL_GPL (smscore_getbuffer );
1650
1650
1651
- /**
1651
+ /*
1652
1652
* return buffer descriptor to a pool
1653
1653
*
1654
1654
* @param coredev pointer to a coredev object returned by
@@ -1693,7 +1693,7 @@ static int smscore_validate_client(struct smscore_device_t *coredev,
1693
1693
return 0 ;
1694
1694
}
1695
1695
1696
- /**
1696
+ /*
1697
1697
* creates smsclient object, check that id is taken by another client
1698
1698
*
1699
1699
* @param coredev pointer to a coredev object from clients hotplug
@@ -1705,7 +1705,7 @@ static int smscore_validate_client(struct smscore_device_t *coredev,
1705
1705
* @param context client-specific context
1706
1706
* @param client pointer to a value that receives created smsclient object
1707
1707
*
1708
- * @ return 0 on success, <0 on error.
1708
+ * return: 0 on success, <0 on error.
1709
1709
*/
1710
1710
int smscore_register_client (struct smscore_device_t * coredev ,
1711
1711
struct smsclient_params_t * params ,
@@ -1740,7 +1740,7 @@ int smscore_register_client(struct smscore_device_t *coredev,
1740
1740
}
1741
1741
EXPORT_SYMBOL_GPL (smscore_register_client );
1742
1742
1743
- /**
1743
+ /*
1744
1744
* frees smsclient object and all subclients associated with it
1745
1745
*
1746
1746
* @param client pointer to smsclient object returned by
@@ -1771,7 +1771,7 @@ void smscore_unregister_client(struct smscore_client_t *client)
1771
1771
}
1772
1772
EXPORT_SYMBOL_GPL (smscore_unregister_client );
1773
1773
1774
- /**
1774
+ /*
1775
1775
* verifies that source id is not taken by another client,
1776
1776
* calls device handler to send requests to the device
1777
1777
*
@@ -1780,7 +1780,7 @@ EXPORT_SYMBOL_GPL(smscore_unregister_client);
1780
1780
* @param buffer pointer to a request buffer
1781
1781
* @param size size (in bytes) of request buffer
1782
1782
*
1783
- * @ return 0 on success, <0 on error.
1783
+ * return: 0 on success, <0 on error.
1784
1784
*/
1785
1785
int smsclient_sendrequest (struct smscore_client_t * client ,
1786
1786
void * buffer , size_t size )
0 commit comments