summaryrefslogtreecommitdiffstats
path: root/net/batman-adv/soft-interface.c
diff options
context:
space:
mode:
Diffstat (limited to 'net/batman-adv/soft-interface.c')
-rw-r--r--net/batman-adv/soft-interface.c41
1 files changed, 21 insertions, 20 deletions
diff --git a/net/batman-adv/soft-interface.c b/net/batman-adv/soft-interface.c
index ba8fd06eee7e..9b66e0edc741 100644
--- a/net/batman-adv/soft-interface.c
+++ b/net/batman-adv/soft-interface.c
@@ -97,7 +97,7 @@ static int batadv_interface_release(struct net_device *dev)
97} 97}
98 98
99/** 99/**
100 * batadv_sum_counter - Sum the cpu-local counters for index 'idx' 100 * batadv_sum_counter() - Sum the cpu-local counters for index 'idx'
101 * @bat_priv: the bat priv with all the soft interface information 101 * @bat_priv: the bat priv with all the soft interface information
102 * @idx: index of counter to sum up 102 * @idx: index of counter to sum up
103 * 103 *
@@ -170,7 +170,7 @@ static int batadv_interface_change_mtu(struct net_device *dev, int new_mtu)
170} 170}
171 171
172/** 172/**
173 * batadv_interface_set_rx_mode - set the rx mode of a device 173 * batadv_interface_set_rx_mode() - set the rx mode of a device
174 * @dev: registered network device to modify 174 * @dev: registered network device to modify
175 * 175 *
176 * We do not actually need to set any rx filters for the virtual batman 176 * We do not actually need to set any rx filters for the virtual batman
@@ -390,7 +390,7 @@ end:
390} 390}
391 391
392/** 392/**
393 * batadv_interface_rx - receive ethernet frame on local batman-adv interface 393 * batadv_interface_rx() - receive ethernet frame on local batman-adv interface
394 * @soft_iface: local interface which will receive the ethernet frame 394 * @soft_iface: local interface which will receive the ethernet frame
395 * @skb: ethernet frame for @soft_iface 395 * @skb: ethernet frame for @soft_iface
396 * @hdr_size: size of already parsed batman-adv header 396 * @hdr_size: size of already parsed batman-adv header
@@ -502,8 +502,8 @@ out:
502} 502}
503 503
504/** 504/**
505 * batadv_softif_vlan_release - release vlan from lists and queue for free after 505 * batadv_softif_vlan_release() - release vlan from lists and queue for free
506 * rcu grace period 506 * after rcu grace period
507 * @ref: kref pointer of the vlan object 507 * @ref: kref pointer of the vlan object
508 */ 508 */
509static void batadv_softif_vlan_release(struct kref *ref) 509static void batadv_softif_vlan_release(struct kref *ref)
@@ -520,7 +520,7 @@ static void batadv_softif_vlan_release(struct kref *ref)
520} 520}
521 521
522/** 522/**
523 * batadv_softif_vlan_put - decrease the vlan object refcounter and 523 * batadv_softif_vlan_put() - decrease the vlan object refcounter and
524 * possibly release it 524 * possibly release it
525 * @vlan: the vlan object to release 525 * @vlan: the vlan object to release
526 */ 526 */
@@ -533,7 +533,7 @@ void batadv_softif_vlan_put(struct batadv_softif_vlan *vlan)
533} 533}
534 534
535/** 535/**
536 * batadv_softif_vlan_get - get the vlan object for a specific vid 536 * batadv_softif_vlan_get() - get the vlan object for a specific vid
537 * @bat_priv: the bat priv with all the soft interface information 537 * @bat_priv: the bat priv with all the soft interface information
538 * @vid: the identifier of the vlan object to retrieve 538 * @vid: the identifier of the vlan object to retrieve
539 * 539 *
@@ -562,7 +562,7 @@ struct batadv_softif_vlan *batadv_softif_vlan_get(struct batadv_priv *bat_priv,
562} 562}
563 563
564/** 564/**
565 * batadv_softif_create_vlan - allocate the needed resources for a new vlan 565 * batadv_softif_create_vlan() - allocate the needed resources for a new vlan
566 * @bat_priv: the bat priv with all the soft interface information 566 * @bat_priv: the bat priv with all the soft interface information
567 * @vid: the VLAN identifier 567 * @vid: the VLAN identifier
568 * 568 *
@@ -614,7 +614,7 @@ int batadv_softif_create_vlan(struct batadv_priv *bat_priv, unsigned short vid)
614} 614}
615 615
616/** 616/**
617 * batadv_softif_destroy_vlan - remove and destroy a softif_vlan object 617 * batadv_softif_destroy_vlan() - remove and destroy a softif_vlan object
618 * @bat_priv: the bat priv with all the soft interface information 618 * @bat_priv: the bat priv with all the soft interface information
619 * @vlan: the object to remove 619 * @vlan: the object to remove
620 */ 620 */
@@ -632,7 +632,7 @@ static void batadv_softif_destroy_vlan(struct batadv_priv *bat_priv,
632} 632}
633 633
634/** 634/**
635 * batadv_interface_add_vid - ndo_add_vid API implementation 635 * batadv_interface_add_vid() - ndo_add_vid API implementation
636 * @dev: the netdev of the mesh interface 636 * @dev: the netdev of the mesh interface
637 * @proto: protocol of the the vlan id 637 * @proto: protocol of the the vlan id
638 * @vid: identifier of the new vlan 638 * @vid: identifier of the new vlan
@@ -690,7 +690,7 @@ static int batadv_interface_add_vid(struct net_device *dev, __be16 proto,
690} 690}
691 691
692/** 692/**
693 * batadv_interface_kill_vid - ndo_kill_vid API implementation 693 * batadv_interface_kill_vid() - ndo_kill_vid API implementation
694 * @dev: the netdev of the mesh interface 694 * @dev: the netdev of the mesh interface
695 * @proto: protocol of the the vlan id 695 * @proto: protocol of the the vlan id
696 * @vid: identifier of the deleted vlan 696 * @vid: identifier of the deleted vlan
@@ -733,7 +733,7 @@ static struct lock_class_key batadv_netdev_xmit_lock_key;
733static struct lock_class_key batadv_netdev_addr_lock_key; 733static struct lock_class_key batadv_netdev_addr_lock_key;
734 734
735/** 735/**
736 * batadv_set_lockdep_class_one - Set lockdep class for a single tx queue 736 * batadv_set_lockdep_class_one() - Set lockdep class for a single tx queue
737 * @dev: device which owns the tx queue 737 * @dev: device which owns the tx queue
738 * @txq: tx queue to modify 738 * @txq: tx queue to modify
739 * @_unused: always NULL 739 * @_unused: always NULL
@@ -746,7 +746,7 @@ static void batadv_set_lockdep_class_one(struct net_device *dev,
746} 746}
747 747
748/** 748/**
749 * batadv_set_lockdep_class - Set txq and addr_list lockdep class 749 * batadv_set_lockdep_class() - Set txq and addr_list lockdep class
750 * @dev: network device to modify 750 * @dev: network device to modify
751 */ 751 */
752static void batadv_set_lockdep_class(struct net_device *dev) 752static void batadv_set_lockdep_class(struct net_device *dev)
@@ -756,7 +756,7 @@ static void batadv_set_lockdep_class(struct net_device *dev)
756} 756}
757 757
758/** 758/**
759 * batadv_softif_init_late - late stage initialization of soft interface 759 * batadv_softif_init_late() - late stage initialization of soft interface
760 * @dev: registered network device to modify 760 * @dev: registered network device to modify
761 * 761 *
762 * Return: error code on failures 762 * Return: error code on failures
@@ -861,7 +861,7 @@ free_bat_counters:
861} 861}
862 862
863/** 863/**
864 * batadv_softif_slave_add - Add a slave interface to a batadv_soft_interface 864 * batadv_softif_slave_add() - Add a slave interface to a batadv_soft_interface
865 * @dev: batadv_soft_interface used as master interface 865 * @dev: batadv_soft_interface used as master interface
866 * @slave_dev: net_device which should become the slave interface 866 * @slave_dev: net_device which should become the slave interface
867 * @extack: extended ACK report struct 867 * @extack: extended ACK report struct
@@ -889,7 +889,7 @@ out:
889} 889}
890 890
891/** 891/**
892 * batadv_softif_slave_del - Delete a slave iface from a batadv_soft_interface 892 * batadv_softif_slave_del() - Delete a slave iface from a batadv_soft_interface
893 * @dev: batadv_soft_interface used as master interface 893 * @dev: batadv_soft_interface used as master interface
894 * @slave_dev: net_device which should be removed from the master interface 894 * @slave_dev: net_device which should be removed from the master interface
895 * 895 *
@@ -1024,7 +1024,7 @@ static const struct ethtool_ops batadv_ethtool_ops = {
1024}; 1024};
1025 1025
1026/** 1026/**
1027 * batadv_softif_free - Deconstructor of batadv_soft_interface 1027 * batadv_softif_free() - Deconstructor of batadv_soft_interface
1028 * @dev: Device to cleanup and remove 1028 * @dev: Device to cleanup and remove
1029 */ 1029 */
1030static void batadv_softif_free(struct net_device *dev) 1030static void batadv_softif_free(struct net_device *dev)
@@ -1040,7 +1040,7 @@ static void batadv_softif_free(struct net_device *dev)
1040} 1040}
1041 1041
1042/** 1042/**
1043 * batadv_softif_init_early - early stage initialization of soft interface 1043 * batadv_softif_init_early() - early stage initialization of soft interface
1044 * @dev: registered network device to modify 1044 * @dev: registered network device to modify
1045 */ 1045 */
1046static void batadv_softif_init_early(struct net_device *dev) 1046static void batadv_softif_init_early(struct net_device *dev)
@@ -1090,7 +1090,7 @@ struct net_device *batadv_softif_create(struct net *net, const char *name)
1090} 1090}
1091 1091
1092/** 1092/**
1093 * batadv_softif_destroy_sysfs - deletion of batadv_soft_interface via sysfs 1093 * batadv_softif_destroy_sysfs() - deletion of batadv_soft_interface via sysfs
1094 * @soft_iface: the to-be-removed batman-adv interface 1094 * @soft_iface: the to-be-removed batman-adv interface
1095 */ 1095 */
1096void batadv_softif_destroy_sysfs(struct net_device *soft_iface) 1096void batadv_softif_destroy_sysfs(struct net_device *soft_iface)
@@ -1112,7 +1112,8 @@ void batadv_softif_destroy_sysfs(struct net_device *soft_iface)
1112} 1112}
1113 1113
1114/** 1114/**
1115 * batadv_softif_destroy_netlink - deletion of batadv_soft_interface via netlink 1115 * batadv_softif_destroy_netlink() - deletion of batadv_soft_interface via
1116 * netlink
1116 * @soft_iface: the to-be-removed batman-adv interface 1117 * @soft_iface: the to-be-removed batman-adv interface
1117 * @head: list pointer 1118 * @head: list pointer
1118 */ 1119 */