net: llc: kerneldoc fixes
authorAndrew Lunn <andrew@lunn.ch>
Sun, 12 Jul 2020 23:15:04 +0000 (01:15 +0200)
committerDavid S. Miller <davem@davemloft.net>
Tue, 14 Jul 2020 00:20:39 +0000 (17:20 -0700)
Simple fixes which require no deep knowledge of the code.

Signed-off-by: Andrew Lunn <andrew@lunn.ch>
Signed-off-by: David S. Miller <davem@davemloft.net>
net/llc/af_llc.c
net/llc/llc_conn.c
net/llc/llc_input.c
net/llc/llc_pdu.c
net/llc/llc_sap.c

index 6e53e43..6140a3e 100644 (file)
@@ -984,7 +984,6 @@ out:
  *     llc_ui_getname - return the address info of a socket
  *     @sock: Socket to get address of.
  *     @uaddr: Address structure to return information.
- *     @uaddrlen: Length of address structure.
  *     @peer: Does user want local or remote address information.
  *
  *     Return the address information of a socket.
index 7b620ac..1144cda 100644 (file)
@@ -284,8 +284,8 @@ out:;
 /**
  *     llc_conn_remove_acked_pdus - Removes acknowledged pdus from tx queue
  *     @sk: active connection
- *     nr: NR
- *     how_many_unacked: size of pdu_unack_q after removing acked pdus
+ *     @nr: NR
+ *     @how_many_unacked: size of pdu_unack_q after removing acked pdus
  *
  *     Removes acknowledged pdus from transmit queue (pdu_unack_q). Returns
  *     the number of pdus that removed from queue.
@@ -906,6 +906,7 @@ static void llc_sk_init(struct sock *sk)
 
 /**
  *     llc_sk_alloc - Allocates LLC sock
+ *     @net: network namespace
  *     @family: upper layer protocol family
  *     @priority: for allocation (%GFP_KERNEL, %GFP_ATOMIC, etc)
  *
@@ -951,7 +952,7 @@ void llc_sk_stop_all_timers(struct sock *sk, bool sync)
 
 /**
  *     llc_sk_free - Frees a LLC socket
- *     @sk - socket to free
+ *     @sk: - socket to free
  *
  *     Frees a LLC socket
  */
index 82cb93f..c309b72 100644 (file)
@@ -144,6 +144,7 @@ static inline int llc_fixup_skb(struct sk_buff *skb)
  *     @skb: received pdu
  *     @dev: device that receive pdu
  *     @pt: packet type
+ *     @orig_dev: the original receive net device
  *
  *     When the system receives a 802.2 frame this function is called. It
  *     checks SAP and connection of received pdu and passes frame to
index 2e6cb79..792d195 100644 (file)
@@ -25,7 +25,7 @@ void llc_pdu_set_cmd_rsp(struct sk_buff *skb, u8 pdu_type)
 
 /**
  *     pdu_set_pf_bit - sets poll/final bit in LLC header
- *     @pdu_frame: input frame that p/f bit must be set into it.
+ *     @skb: Frame to set bit in
  *     @bit_value: poll/final bit (0 or 1).
  *
  *     This function sets poll/final bit in LLC header (based on type of PDU).
index be41906..6805ce4 100644 (file)
@@ -37,6 +37,7 @@ static int llc_mac_header_len(unsigned short devtype)
 
 /**
  *     llc_alloc_frame - allocates sk_buff for frame
+ *     @sk:  socket to allocate frame to
  *     @dev: network device this skb will be sent over
  *     @type: pdu type to allocate
  *     @data_size: data size to allocate
@@ -273,6 +274,7 @@ void llc_build_and_send_xid_pkt(struct llc_sap *sap, struct sk_buff *skb,
  *     llc_sap_rcv - sends received pdus to the sap state machine
  *     @sap: current sap component structure.
  *     @skb: received frame.
+ *     @sk:  socket to associate to frame
  *
  *     Sends received pdus to the sap state machine.
  */
@@ -379,6 +381,7 @@ static void llc_do_mcast(struct llc_sap *sap, struct sk_buff *skb,
  *     llc_sap_mcast - Deliver multicast PDU's to all matching datagram sockets.
  *     @sap: SAP
  *     @laddr: address of local LLC (MAC + SAP)
+ *     @skb: PDU to deliver
  *
  *     Search socket list of the SAP and finds connections with same sap.
  *     Deliver clone to each.