From owner-p4-projects@FreeBSD.ORG Tue Feb 19 18:42:44 2008 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id CE73816A419; Tue, 19 Feb 2008 18:42:44 +0000 (UTC) Delivered-To: perforce@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9347E16A417 for ; Tue, 19 Feb 2008 18:42:44 +0000 (UTC) (envelope-from hselasky@FreeBSD.org) Received: from repoman.freebsd.org (repoman.freebsd.org [IPv6:2001:4f8:fff6::29]) by mx1.freebsd.org (Postfix) with ESMTP id 8232F13C4DD for ; Tue, 19 Feb 2008 18:42:44 +0000 (UTC) (envelope-from hselasky@FreeBSD.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.14.1/8.14.1) with ESMTP id m1JIgin8086576 for ; Tue, 19 Feb 2008 18:42:44 GMT (envelope-from hselasky@FreeBSD.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.14.1/8.14.1/Submit) id m1JIgiEJ086573 for perforce@freebsd.org; Tue, 19 Feb 2008 18:42:44 GMT (envelope-from hselasky@FreeBSD.org) Date: Tue, 19 Feb 2008 18:42:44 GMT Message-Id: <200802191842.m1JIgiEJ086573@repoman.freebsd.org> X-Authentication-Warning: repoman.freebsd.org: perforce set sender to hselasky@FreeBSD.org using -f From: Hans Petter Selasky To: Perforce Change Reviews Cc: Subject: PERFORCE change 135736 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 19 Feb 2008 18:42:45 -0000 http://perforce.freebsd.org/chv.cgi?CH=135736 Change 135736 by hselasky@hselasky_laptop001 on 2008/02/19 18:41:43 Add more documentation. Affected files ... .. //depot/projects/usb/src/sys/dev/usb/usb_template.c#14 edit Differences ... ==== //depot/projects/usb/src/sys/dev/usb/usb_template.c#14 (text+ko) ==== @@ -46,6 +46,9 @@ #include #include +/*------------------------------------------------------------------------* + * usbd_make_raw_desc + *------------------------------------------------------------------------*/ static void usbd_make_raw_desc(struct usbd_temp_setup *temp, const uint8_t *raw) @@ -82,6 +85,9 @@ return; } +/*------------------------------------------------------------------------* + * usbd_make_endpoint_desc + *------------------------------------------------------------------------*/ static void usbd_make_endpoint_desc(struct usbd_temp_setup *temp, const struct usb_temp_endpoint_desc *ted) @@ -176,6 +182,9 @@ return; } +/*------------------------------------------------------------------------* + * usbd_make_interface_desc + *------------------------------------------------------------------------*/ static void usbd_make_interface_desc(struct usbd_temp_setup *temp, const struct usb_temp_interface_desc *tid) @@ -241,6 +250,9 @@ return; } +/*------------------------------------------------------------------------* + * usbd_make_config_desc + *------------------------------------------------------------------------*/ static void usbd_make_config_desc(struct usbd_temp_setup *temp, const struct usb_temp_config_desc *tcd) @@ -297,6 +309,9 @@ return; } +/*------------------------------------------------------------------------* + * usbd_make_device_desc + *------------------------------------------------------------------------*/ static void usbd_make_device_desc(struct usbd_temp_setup *temp, const struct usb_temp_device_desc *tdd) @@ -387,6 +402,9 @@ return; } +/*------------------------------------------------------------------------* + * usbd_hw_ep_match + *------------------------------------------------------------------------*/ static uint8_t usbd_hw_ep_match(const struct usbd_hw_ep_profile *pf, uint8_t ep_type, uint8_t ep_dir_in) @@ -406,6 +424,9 @@ return (0); } +/*------------------------------------------------------------------------* + * usbd_hw_ep_find_match + *------------------------------------------------------------------------*/ static uint8_t usbd_hw_ep_find_match(struct usbd_hw_ep_scratch *ues, struct usbd_sw_ep_scratch *ep, uint8_t is_simplex) @@ -517,6 +538,9 @@ return (1); /* failure */ } +/*------------------------------------------------------------------------* + * usbd_hw_ep_get_needs + *------------------------------------------------------------------------*/ static uint8_t usbd_hw_ep_get_needs(struct usbd_hw_ep_scratch *ues, uint8_t ep_type, uint8_t is_complete) @@ -665,6 +689,13 @@ goto repeat; } +/*------------------------------------------------------------------------* + * usbd_hw_ep_resolve + * + * Return values: + * 0: Success + * Else: Failure + *------------------------------------------------------------------------*/ static usbd_status_t usbd_hw_ep_resolve(struct usbd_device *udev, usb_descriptor_t *desc)