source: mainline/uspace/lib/usbdev/include/usb/dev/request.h@ b7fd2a0

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since b7fd2a0 was b7fd2a0, checked in by Jiří Zárevúcky <zarevucky.jiri@…>, 7 years ago

Use errno_t in all uspace and kernel code.

Change type of every variable, parameter and return value that holds an
<errno.h> constant to either errno_t (the usual case), or sys_errno_t
(some places in kernel). This is for the purpose of self-documentation,
as well as for type-checking with a bit of type definition hackery.

Although this is a massive commit, it is a simple text replacement, and thus
is very easy to verify. Simply do the following:

`
git checkout <this commit's hash>
git reset HEAD
git add .
tools/srepl '\berrno_t\b' int
git add .
tools/srepl '\bsys_errno_t\b' sysarg_t
git reset
git diff
`

While this doesn't ensure that the replacements are correct, it does ensure
that the commit doesn't do anything except those replacements. Since errno_t
is typedef'd to int in the usual case (and sys_errno_t to sysarg_t), even if
incorrect, this commit cannot change behavior.
  • Property mode set to 100644
File size: 3.9 KB
Line 
1/*
2 * Copyright (c) 2011 Vojtech Horky
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29/** @addtogroup libusbdev
30 * @{
31 */
32/** @file
33 * Standard USB requests.
34 */
35#ifndef LIBUSBDEV_REQUEST_H_
36#define LIBUSBDEV_REQUEST_H_
37
38#include <stddef.h>
39#include <stdint.h>
40#include <l18n/langs.h>
41#include <usb/usb.h>
42#include <usb/dev/pipes.h>
43#include <usb/descriptor.h>
44#include <usb/request.h>
45
46errno_t usb_control_request_set(usb_pipe_t *,
47 usb_request_type_t, usb_request_recipient_t, uint8_t,
48 uint16_t, uint16_t, const void *, size_t);
49
50errno_t usb_control_request_get(usb_pipe_t *,
51 usb_request_type_t, usb_request_recipient_t, uint8_t,
52 uint16_t, uint16_t, void *, size_t, size_t *);
53
54errno_t usb_request_get_status(usb_pipe_t *, usb_request_recipient_t,
55 uint16_t, uint16_t *);
56errno_t usb_request_clear_feature(usb_pipe_t *, usb_request_type_t,
57 usb_request_recipient_t, uint16_t, uint16_t);
58errno_t usb_request_set_feature(usb_pipe_t *, usb_request_type_t,
59 usb_request_recipient_t, uint16_t, uint16_t);
60errno_t usb_request_get_descriptor(usb_pipe_t *, usb_request_type_t,
61 usb_request_recipient_t, uint8_t, uint8_t, uint16_t, void *, size_t,
62 size_t *);
63errno_t usb_request_get_descriptor_alloc(usb_pipe_t *, usb_request_type_t,
64 usb_request_recipient_t, uint8_t, uint8_t, uint16_t, void **, size_t *);
65errno_t usb_request_get_device_descriptor(usb_pipe_t *,
66 usb_standard_device_descriptor_t *);
67errno_t usb_request_get_bare_configuration_descriptor(usb_pipe_t *, int,
68 usb_standard_configuration_descriptor_t *);
69errno_t usb_request_get_full_configuration_descriptor(usb_pipe_t *, int,
70 void *, size_t, size_t *);
71errno_t usb_request_get_full_configuration_descriptor_alloc(usb_pipe_t *,
72 int, const void **, size_t *);
73errno_t usb_request_set_descriptor(usb_pipe_t *, usb_request_type_t,
74 usb_request_recipient_t, uint8_t, uint8_t, uint16_t, const void *, size_t);
75
76errno_t usb_request_get_configuration(usb_pipe_t *, uint8_t *);
77errno_t usb_request_set_configuration(usb_pipe_t *, uint8_t);
78
79errno_t usb_request_get_interface(usb_pipe_t *, uint8_t, uint8_t *);
80errno_t usb_request_set_interface(usb_pipe_t *, uint8_t, uint8_t);
81
82errno_t usb_request_get_supported_languages(usb_pipe_t *,
83 l18_win_locales_t **, size_t *);
84errno_t usb_request_get_string(usb_pipe_t *, size_t, l18_win_locales_t,
85 char **);
86
87errno_t usb_request_clear_endpoint_halt(usb_pipe_t *, uint16_t);
88errno_t usb_pipe_clear_halt(usb_pipe_t *, usb_pipe_t *);
89errno_t usb_request_get_endpoint_status(usb_pipe_t *, usb_pipe_t *, uint16_t *);
90
91#endif
92/**
93 * @}
94 */
Note: See TracBrowser for help on using the repository browser.