mirror of https://gitee.com/openkylin/linux.git
usb: c67x00: c67x00-sched: Demote obvious misuse of kerneldoc to standard comment blocks
No attempt has been made to document any of the functions here. Fixes the following W=1 kernel build warning(s): drivers/usb/c67x00/c67x00-sched.c:35: warning: Function parameter or member 'queue' not described in 'c67x00_ep_data' drivers/usb/c67x00/c67x00-sched.c:35: warning: Function parameter or member 'node' not described in 'c67x00_ep_data' drivers/usb/c67x00/c67x00-sched.c:35: warning: Function parameter or member 'hep' not described in 'c67x00_ep_data' drivers/usb/c67x00/c67x00-sched.c:35: warning: Function parameter or member 'dev' not described in 'c67x00_ep_data' drivers/usb/c67x00/c67x00-sched.c:35: warning: Function parameter or member 'next_frame' not described in 'c67x00_ep_data' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'ly_base_addr' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'port_length' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'pid_ep' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'dev_addr' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'ctrl_reg' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'status' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'retry_cnt' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'residue' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'next_td_addr' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'td_list' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'td_addr' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'data' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'urb' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'privdata' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'ep_data' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:71: warning: Function parameter or member 'pipe' not described in 'c67x00_td' drivers/usb/c67x00/c67x00-sched.c:137: warning: Function parameter or member 'c67x00' not described in 'dbg_td' drivers/usb/c67x00/c67x00-sched.c:137: warning: Function parameter or member 'td' not described in 'dbg_td' drivers/usb/c67x00/c67x00-sched.c:137: warning: Function parameter or member 'msg' not described in 'dbg_td' drivers/usb/c67x00/c67x00-sched.c:169: warning: Function parameter or member 'a' not described in 'frame_add' drivers/usb/c67x00/c67x00-sched.c:169: warning: Function parameter or member 'b' not described in 'frame_add' drivers/usb/c67x00/c67x00-sched.c:177: warning: Function parameter or member 'a' not described in 'frame_after' drivers/usb/c67x00/c67x00-sched.c:177: warning: Function parameter or member 'b' not described in 'frame_after' drivers/usb/c67x00/c67x00-sched.c:186: warning: Function parameter or member 'a' not described in 'frame_after_eq' drivers/usb/c67x00/c67x00-sched.c:186: warning: Function parameter or member 'b' not described in 'frame_after_eq' drivers/usb/c67x00/c67x00-sched.c:199: warning: Function parameter or member 'c67x00' not described in 'c67x00_release_urb' drivers/usb/c67x00/c67x00-sched.c:199: warning: Function parameter or member 'urb' not described in 'c67x00_release_urb' drivers/usb/c67x00/c67x00-sched.c:566: warning: Function parameter or member 'c67x00' not described in 'c67x00_create_td' drivers/usb/c67x00/c67x00-sched.c:566: warning: Function parameter or member 'urb' not described in 'c67x00_create_td' drivers/usb/c67x00/c67x00-sched.c:566: warning: Function parameter or member 'data' not described in 'c67x00_create_td' drivers/usb/c67x00/c67x00-sched.c:566: warning: Function parameter or member 'len' not described in 'c67x00_create_td' drivers/usb/c67x00/c67x00-sched.c:566: warning: Function parameter or member 'pid' not described in 'c67x00_create_td' drivers/usb/c67x00/c67x00-sched.c:566: warning: Function parameter or member 'toggle' not described in 'c67x00_create_td' drivers/usb/c67x00/c67x00-sched.c:566: warning: Function parameter or member 'privdata' not described in 'c67x00_create_td' drivers/usb/c67x00/c67x00-sched.c:692: warning: Function parameter or member 'c67x00' not described in 'c67x00_add_ctrl_urb' drivers/usb/c67x00/c67x00-sched.c:692: warning: Function parameter or member 'urb' not described in 'c67x00_add_ctrl_urb' drivers/usb/c67x00/c67x00-sched.c:830: warning: Function parameter or member 'c67x00' not described in 'c67x00_parse_td' drivers/usb/c67x00/c67x00-sched.c:830: warning: Function parameter or member 'td' not described in 'c67x00_parse_td' drivers/usb/c67x00/c67x00-sched.c:978: warning: Function parameter or member 'c67x00' not described in 'c67x00_check_td_list' drivers/usb/c67x00/c67x00-sched.c:1052: warning: Function parameter or member 'c67x00' not described in 'c67x00_send_td' drivers/usb/c67x00/c67x00-sched.c:1052: warning: Function parameter or member 'td' not described in 'c67x00_send_td' drivers/usb/c67x00/c67x00-sched.c:1088: warning: Function parameter or member 'c67x00' not described in 'c67x00_do_work' Cc: Peter Korsgaard <jacmet@sunsite.dk> Signed-off-by: Lee Jones <lee.jones@linaro.org> Link: https://lore.kernel.org/r/20200702144625.2533530-31-lee.jones@linaro.org Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
Lee Jones
Greg Kroah-Hartman
parent
aa37c246f2
commit
aa88cddf4c
|
|
@ -23,7 +23,7 @@
|
|||
|
||||
/* -------------------------------------------------------------------------- */
|
||||
|
||||
/**
|
||||
/*
|
||||
* struct c67x00_ep_data: Host endpoint data structure
|
||||
*/
|
||||
struct c67x00_ep_data {
|
||||
|
|
@ -34,7 +34,7 @@ struct c67x00_ep_data {
|
|||
u16 next_frame; /* For int/isoc transactions */
|
||||
};
|
||||
|
||||
/**
|
||||
/*
|
||||
* struct c67x00_td
|
||||
*
|
||||
* Hardware parts are little endiannes, SW in CPU endianess.
|
||||
|
|
@ -130,7 +130,7 @@ struct c67x00_urb_priv {
|
|||
|
||||
/* -------------------------------------------------------------------------- */
|
||||
|
||||
/**
|
||||
/*
|
||||
* dbg_td - Dump the contents of the TD
|
||||
*/
|
||||
static void dbg_td(struct c67x00_hcd *c67x00, struct c67x00_td *td, char *msg)
|
||||
|
|
@ -161,7 +161,7 @@ static inline u16 c67x00_get_current_frame_number(struct c67x00_hcd *c67x00)
|
|||
return c67x00_ll_husb_get_frame(c67x00->sie) & HOST_FRAME_MASK;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* frame_add
|
||||
* Software wraparound for framenumbers.
|
||||
*/
|
||||
|
|
@ -170,7 +170,7 @@ static inline u16 frame_add(u16 a, u16 b)
|
|||
return (a + b) & HOST_FRAME_MASK;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* frame_after - is frame a after frame b
|
||||
*/
|
||||
static inline int frame_after(u16 a, u16 b)
|
||||
|
|
@ -179,7 +179,7 @@ static inline int frame_after(u16 a, u16 b)
|
|||
(HOST_FRAME_MASK / 2);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* frame_after_eq - is frame a after or equal to frame b
|
||||
*/
|
||||
static inline int frame_after_eq(u16 a, u16 b)
|
||||
|
|
@ -190,7 +190,7 @@ static inline int frame_after_eq(u16 a, u16 b)
|
|||
|
||||
/* -------------------------------------------------------------------------- */
|
||||
|
||||
/**
|
||||
/*
|
||||
* c67x00_release_urb - remove link from all tds to this urb
|
||||
* Disconnects the urb from it's tds, so that it can be given back.
|
||||
* pre: urb->hcpriv != NULL
|
||||
|
|
@ -557,7 +557,7 @@ static int c67x00_claim_frame_bw(struct c67x00_hcd *c67x00, struct urb *urb,
|
|||
|
||||
/* -------------------------------------------------------------------------- */
|
||||
|
||||
/**
|
||||
/*
|
||||
* td_addr and buf_addr must be word aligned
|
||||
*/
|
||||
static int c67x00_create_td(struct c67x00_hcd *c67x00, struct urb *urb,
|
||||
|
|
@ -685,7 +685,7 @@ static int c67x00_add_data_urb(struct c67x00_hcd *c67x00, struct urb *urb)
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* return 0 in case more bandwidth is available, else errorcode
|
||||
*/
|
||||
static int c67x00_add_ctrl_urb(struct c67x00_hcd *c67x00, struct urb *urb)
|
||||
|
|
@ -822,7 +822,7 @@ static void c67x00_fill_frame(struct c67x00_hcd *c67x00)
|
|||
|
||||
/* -------------------------------------------------------------------------- */
|
||||
|
||||
/**
|
||||
/*
|
||||
* Get TD from C67X00
|
||||
*/
|
||||
static inline void
|
||||
|
|
@ -970,7 +970,7 @@ static void c67x00_handle_isoc(struct c67x00_hcd *c67x00, struct c67x00_td *td)
|
|||
|
||||
/* -------------------------------------------------------------------------- */
|
||||
|
||||
/**
|
||||
/*
|
||||
* c67x00_check_td_list - handle tds which have been processed by the c67x00
|
||||
* pre: current_td == 0
|
||||
*/
|
||||
|
|
@ -1045,7 +1045,7 @@ static inline int c67x00_all_tds_processed(struct c67x00_hcd *c67x00)
|
|||
return !c67x00_ll_husb_get_current_td(c67x00->sie);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Send td to C67X00
|
||||
*/
|
||||
static void c67x00_send_td(struct c67x00_hcd *c67x00, struct c67x00_td *td)
|
||||
|
|
@ -1081,7 +1081,7 @@ static void c67x00_send_frame(struct c67x00_hcd *c67x00)
|
|||
|
||||
/* -------------------------------------------------------------------------- */
|
||||
|
||||
/**
|
||||
/*
|
||||
* c67x00_do_work - Schedulers state machine
|
||||
*/
|
||||
static void c67x00_do_work(struct c67x00_hcd *c67x00)
|
||||
|
|
|
|||
Loading…
Reference in New Issue