source: mainline/uspace/lib/device/include/devman.h@ 77a0119

Last change on this file since 77a0119 was 8300c72, checked in by Jiri Svoboda <jiri@…>, 4 months ago

Quiesce devices before proceeding with shutdown.

Only implemented for e1k, uhci and xhci.

  • Property mode set to 100644
File size: 4.0 KB
Line 
1/*
2 * Copyright (c) 2025 Jiri Svoboda
3 * Copyright (c) 2010 Lenka Trochtova
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 *
10 * - Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * - Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * - The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 */
29
30/** @addtogroup libdevice
31 * @{
32 */
33/** @file
34 */
35
36#ifndef LIBDEVICE_DEVMAN_H
37#define LIBDEVICE_DEVMAN_H
38
39#include <ipc/devman.h>
40#include <ipc/loc.h>
41#include <async.h>
42#include <stdbool.h>
43
44extern async_exch_t *devman_exchange_begin_blocking(iface_t);
45extern async_exch_t *devman_exchange_begin(iface_t);
46extern void devman_exchange_end(async_exch_t *);
47
48extern errno_t devman_driver_register(const char *);
49extern errno_t devman_add_function(const char *, fun_type_t, match_id_list_t *,
50 devman_handle_t, devman_handle_t *);
51extern errno_t devman_remove_function(devman_handle_t);
52extern errno_t devman_drv_fun_online(devman_handle_t);
53extern errno_t devman_drv_fun_offline(devman_handle_t);
54extern errno_t devman_drv_fun_quiesce(devman_handle_t);
55extern errno_t devman_drv_fun_wait_stable(devman_handle_t);
56
57extern async_sess_t *devman_device_connect(devman_handle_t, unsigned int);
58extern async_sess_t *devman_parent_device_connect(devman_handle_t,
59 unsigned int);
60
61extern errno_t devman_fun_get_handle(const char *, devman_handle_t *,
62 unsigned int);
63extern errno_t devman_fun_get_child(devman_handle_t, devman_handle_t *);
64extern errno_t devman_dev_get_parent(devman_handle_t, devman_handle_t *);
65extern errno_t devman_dev_get_functions(devman_handle_t, devman_handle_t **,
66 size_t *);
67extern errno_t devman_fun_get_match_id(devman_handle_t, size_t, char *, size_t,
68 unsigned int *);
69extern errno_t devman_fun_get_name(devman_handle_t, char *, size_t);
70extern errno_t devman_fun_get_driver_name(devman_handle_t, char *, size_t);
71extern errno_t devman_fun_get_path(devman_handle_t, char *, size_t);
72extern errno_t devman_fun_online(devman_handle_t);
73extern errno_t devman_fun_offline(devman_handle_t);
74extern errno_t devman_fun_quiesce(devman_handle_t);
75
76extern errno_t devman_add_device_to_category(devman_handle_t, const char *);
77extern errno_t devman_fun_sid_to_handle(service_id_t, devman_handle_t *);
78extern errno_t devman_quiesce_devices(const char *);
79extern errno_t devman_get_drivers(devman_handle_t **, size_t *);
80extern errno_t devman_driver_get_devices(devman_handle_t, devman_handle_t **,
81 size_t *);
82extern errno_t devman_driver_get_handle(const char *, devman_handle_t *);
83extern errno_t devman_driver_get_match_id(devman_handle_t, size_t, char *, size_t,
84 unsigned int *);
85extern errno_t devman_driver_get_name(devman_handle_t, char *, size_t);
86extern errno_t devman_driver_get_state(devman_handle_t, driver_state_t *);
87extern errno_t devman_driver_load(devman_handle_t);
88extern errno_t devman_driver_unload(devman_handle_t);
89
90#endif
91
92/** @}
93 */
Note: See TracBrowser for help on using the repository browser.