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

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since a53ed3a 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
RevLine 
[0a37e14]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
[160b75e]29/** @addtogroup libusbdev
[0a37e14]30 * @{
31 */
32/** @file
33 * Standard USB requests.
34 */
[7d521e24]35#ifndef LIBUSBDEV_REQUEST_H_
36#define LIBUSBDEV_REQUEST_H_
[0a37e14]37
[8d2dd7f2]38#include <stddef.h>
39#include <stdint.h>
[1a6a234]40#include <l18n/langs.h>
[0a37e14]41#include <usb/usb.h>
[7d521e24]42#include <usb/dev/pipes.h>
[abe8ac5]43#include <usb/descriptor.h>
[971fbfde]44#include <usb/request.h>
[0a37e14]45
[b7fd2a0]46errno_t usb_control_request_set(usb_pipe_t *,
[a4a8cca]47 usb_request_type_t, usb_request_recipient_t, uint8_t,
[f8d43aa]48 uint16_t, uint16_t, const void *, size_t);
[a4a8cca]49
[b7fd2a0]50errno_t usb_control_request_get(usb_pipe_t *,
[a4a8cca]51 usb_request_type_t, usb_request_recipient_t, uint8_t,
52 uint16_t, uint16_t, void *, size_t, size_t *);
53
[b7fd2a0]54errno_t usb_request_get_status(usb_pipe_t *, usb_request_recipient_t,
[9cf1c5a]55 uint16_t, uint16_t *);
[b7fd2a0]56errno_t usb_request_clear_feature(usb_pipe_t *, usb_request_type_t,
[9cf1c5a]57 usb_request_recipient_t, uint16_t, uint16_t);
[b7fd2a0]58errno_t usb_request_set_feature(usb_pipe_t *, usb_request_type_t,
[9cf1c5a]59 usb_request_recipient_t, uint16_t, uint16_t);
[b7fd2a0]60errno_t usb_request_get_descriptor(usb_pipe_t *, usb_request_type_t,
[3238506]61 usb_request_recipient_t, uint8_t, uint8_t, uint16_t, void *, size_t,
[ad4562c2]62 size_t *);
[b7fd2a0]63errno_t usb_request_get_descriptor_alloc(usb_pipe_t *, usb_request_type_t,
[ad4562c2]64 usb_request_recipient_t, uint8_t, uint8_t, uint16_t, void **, size_t *);
[b7fd2a0]65errno_t usb_request_get_device_descriptor(usb_pipe_t *,
[abe8ac5]66 usb_standard_device_descriptor_t *);
[b7fd2a0]67errno_t usb_request_get_bare_configuration_descriptor(usb_pipe_t *, int,
[abe8ac5]68 usb_standard_configuration_descriptor_t *);
[b7fd2a0]69errno_t usb_request_get_full_configuration_descriptor(usb_pipe_t *, int,
[abe8ac5]70 void *, size_t, size_t *);
[b7fd2a0]71errno_t usb_request_get_full_configuration_descriptor_alloc(usb_pipe_t *,
[0eb2a0f]72 int, const void **, size_t *);
[b7fd2a0]73errno_t usb_request_set_descriptor(usb_pipe_t *, usb_request_type_t,
[f8d43aa]74 usb_request_recipient_t, uint8_t, uint8_t, uint16_t, const void *, size_t);
[99a1a56]75
[b7fd2a0]76errno_t usb_request_get_configuration(usb_pipe_t *, uint8_t *);
77errno_t usb_request_set_configuration(usb_pipe_t *, uint8_t);
[bb512b2d]78
[b7fd2a0]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);
[0a37e14]81
[b7fd2a0]82errno_t usb_request_get_supported_languages(usb_pipe_t *,
[1a6a234]83 l18_win_locales_t **, size_t *);
[b7fd2a0]84errno_t usb_request_get_string(usb_pipe_t *, size_t, l18_win_locales_t,
[b84e114]85 char **);
[1a6a234]86
[b7fd2a0]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 *);
[c19329a]90
[0a37e14]91#endif
92/**
93 * @}
94 */
Note: See TracBrowser for help on using the repository browser.