aboutsummaryrefslogtreecommitdiffstats
path: root/drivers/usb
diff options
context:
space:
mode:
authorGreg Kroah-Hartman <gregkh@linuxfoundation.org>2012-03-08 16:58:13 -0500
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>2012-03-08 16:58:13 -0500
commitdd63b0b4d6d036e1d5f7008c97c30789415489de (patch)
treec9f68fb94b846083249977f1b9d6413d5cae4507 /drivers/usb
parent9fbd1649d54edc614c64ab075f7485622fd6450a (diff)
USB: serial: metro-usb: remove function header comments
They aren't needed, make the checkpatch tool unhappy, and in some places, aren't even correct. So just remove them, they get in the way and are messy. Cc: Aleksey Babahin <tamerlan311@gmail.com> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Diffstat (limited to 'drivers/usb')
-rw-r--r--drivers/usb/serial/metro-usb.c110
1 files changed, 0 insertions, 110 deletions
diff --git a/drivers/usb/serial/metro-usb.c b/drivers/usb/serial/metro-usb.c
index 8758e01289b9..e968d3396813 100644
--- a/drivers/usb/serial/metro-usb.c
+++ b/drivers/usb/serial/metro-usb.c
@@ -56,17 +56,6 @@ MODULE_DEVICE_TABLE(usb, id_table);
56/* Input parameter constants. */ 56/* Input parameter constants. */
57static bool debug; 57static bool debug;
58 58
59/* ----------------------------------------------------------------------------------------------
60 Description:
61 Read the port from the read interrupt.
62
63 Input:
64 struct urb *: urb structure to get data.
65 struct pt_regs *: pt_regs structure.
66
67 Output:
68 None:
69*/
70static void metrousb_read_int_callback(struct urb *urb) 59static void metrousb_read_int_callback(struct urb *urb)
71{ 60{
72 struct usb_serial_port *port = (struct usb_serial_port *)urb->context; 61 struct usb_serial_port *port = (struct usb_serial_port *)urb->context;
@@ -144,16 +133,6 @@ exit:
144 } 133 }
145} 134}
146 135
147/* ----------------------------------------------------------------------------------------------
148 Description:
149 Clean up any urbs and port information.
150
151 Input:
152 struct usb_serial_port *: pointer to a usb_serial_port structure.
153
154 Output:
155 int: Returns true (0) if successful, false otherwise.
156*/
157static void metrousb_cleanup(struct usb_serial_port *port) 136static void metrousb_cleanup(struct usb_serial_port *port)
158{ 137{
159 dbg("METRO-USB - %s - port number=%d", __FUNCTION__, port->number); 138 dbg("METRO-USB - %s - port number=%d", __FUNCTION__, port->number);
@@ -167,17 +146,6 @@ static void metrousb_cleanup(struct usb_serial_port *port)
167 } 146 }
168} 147}
169 148
170/* ----------------------------------------------------------------------------------------------
171 Description:
172 Open the drivers serial port.
173
174 Input:
175 struct usb_serial_port *: pointer to a usb_serial_port structure.
176 struct file *: pointer to a file structure.
177
178 Output:
179 int: Returns true (0) if successful, false otherwise.
180*/
181static int metrousb_open(struct tty_struct *tty, struct usb_serial_port *port) 149static int metrousb_open(struct tty_struct *tty, struct usb_serial_port *port)
182{ 150{
183 struct usb_serial *serial = port->serial; 151 struct usb_serial *serial = port->serial;
@@ -229,17 +197,6 @@ exit:
229 return result; 197 return result;
230} 198}
231 199
232/* ----------------------------------------------------------------------------------------------
233 Description:
234 Set the modem control state for the entered serial port.
235
236 Input:
237 struct usb_serial_port *: pointer to a usb_serial_port structure.
238 unsigned int: control state value to set.
239
240 Output:
241 int: Returns true (0) if successful, false otherwise.
242*/
243static int metrousb_set_modem_ctrl(struct usb_serial *serial, unsigned int control_state) 200static int metrousb_set_modem_ctrl(struct usb_serial *serial, unsigned int control_state)
244{ 201{
245 int retval = 0; 202 int retval = 0;
@@ -263,17 +220,6 @@ static int metrousb_set_modem_ctrl(struct usb_serial *serial, unsigned int contr
263 return retval; 220 return retval;
264} 221}
265 222
266
267/* ----------------------------------------------------------------------------------------------
268 Description:
269 Shutdown the driver.
270
271 Input:
272 struct usb_serial *: pointer to a usb-serial structure.
273
274 Output:
275 int: Returns true (0) if successful, false otherwise.
276*/
277static void metrousb_shutdown(struct usb_serial *serial) 223static void metrousb_shutdown(struct usb_serial *serial)
278{ 224{
279 int i = 0; 225 int i = 0;
@@ -293,16 +239,6 @@ static void metrousb_shutdown(struct usb_serial *serial)
293 } 239 }
294} 240}
295 241
296/* ----------------------------------------------------------------------------------------------
297 Description:
298 Startup the driver.
299
300 Input:
301 struct usb_serial *: pointer to a usb-serial structure.
302
303 Output:
304 int: Returns true (0) if successful, false otherwise.
305*/
306static int metrousb_startup(struct usb_serial *serial) 242static int metrousb_startup(struct usb_serial *serial)
307{ 243{
308 struct metrousb_private *metro_priv; 244 struct metrousb_private *metro_priv;
@@ -334,16 +270,6 @@ static int metrousb_startup(struct usb_serial *serial)
334 return 0; 270 return 0;
335} 271}
336 272
337/* ----------------------------------------------------------------------------------------------
338 Description:
339 Set the serial port throttle to stop reading from the port.
340
341 Input:
342 struct usb_serial_port *: pointer to a usb_serial_port structure.
343
344 Output:
345 None:
346*/
347static void metrousb_throttle(struct tty_struct *tty) 273static void metrousb_throttle(struct tty_struct *tty)
348{ 274{
349 struct usb_serial_port *port = tty->driver_data; 275 struct usb_serial_port *port = tty->driver_data;
@@ -358,17 +284,6 @@ static void metrousb_throttle(struct tty_struct *tty)
358 spin_unlock_irqrestore(&metro_priv->lock, flags); 284 spin_unlock_irqrestore(&metro_priv->lock, flags);
359} 285}
360 286
361/* ----------------------------------------------------------------------------------------------
362 Description:
363 Get the serial port control line states.
364
365 Input:
366 struct usb_serial_port *: pointer to a usb_serial_port structure.
367 struct file *: pointer to a file structure.
368
369 Output:
370 int: Returns the state of the control lines.
371*/
372static int metrousb_tiocmget(struct tty_struct *tty) 287static int metrousb_tiocmget(struct tty_struct *tty)
373{ 288{
374 unsigned long control_state = 0; 289 unsigned long control_state = 0;
@@ -385,19 +300,6 @@ static int metrousb_tiocmget(struct tty_struct *tty)
385 return control_state; 300 return control_state;
386} 301}
387 302
388/* ----------------------------------------------------------------------------------------------
389 Description:
390 Set the serial port control line states.
391
392 Input:
393 struct usb_serial_port *: pointer to a usb_serial_port structure.
394 struct file *: pointer to a file structure.
395 unsigned int: line state to set.
396 unsigned int: line state to clear.
397
398 Output:
399 int: Returns the state of the control lines.
400*/
401static int metrousb_tiocmset(struct tty_struct *tty, 303static int metrousb_tiocmset(struct tty_struct *tty,
402 unsigned int set, unsigned int clear) 304 unsigned int set, unsigned int clear)
403{ 305{
@@ -427,16 +329,6 @@ static int metrousb_tiocmset(struct tty_struct *tty,
427 return metrousb_set_modem_ctrl(serial, control_state); 329 return metrousb_set_modem_ctrl(serial, control_state);
428} 330}
429 331
430/* ----------------------------------------------------------------------------------------------
431 Description:
432 Set the serial port unthrottle to resume reading from the port.
433
434 Input:
435 struct usb_serial_port *: pointer to a usb_serial_port structure.
436
437 Output:
438 None:
439*/
440static void metrousb_unthrottle(struct tty_struct *tty) 332static void metrousb_unthrottle(struct tty_struct *tty)
441{ 333{
442 struct usb_serial_port *port = tty->driver_data; 334 struct usb_serial_port *port = tty->driver_data;
@@ -460,7 +352,6 @@ static void metrousb_unthrottle(struct tty_struct *tty)
460 } 352 }
461} 353}
462 354
463/* Driver structure. */
464static struct usb_driver metrousb_driver = { 355static struct usb_driver metrousb_driver = {
465 .name = "metro-usb", 356 .name = "metro-usb",
466 .probe = usb_serial_probe, 357 .probe = usb_serial_probe,
@@ -468,7 +359,6 @@ static struct usb_driver metrousb_driver = {
468 .id_table = id_table 359 .id_table = id_table
469}; 360};
470 361
471/* Device structure. */
472static struct usb_serial_driver metrousb_device = { 362static struct usb_serial_driver metrousb_device = {
473 .driver = { 363 .driver = {
474 .owner = THIS_MODULE, 364 .owner = THIS_MODULE,