6f65b50546
With the upcoming usage from LinuxKPI but also from drivers
ported natively we are seeing more probing of various
firmware (names).
Add the ability to firmware(9) to silence the
"firmware image loading/registering errors" by adding a new
firmware_get_flags() functions extending firmware_get() and
taking a flags argument as firmware_put() already does.
Requested-by: zeising (for future LinuxKPI/DRM)
Sponsored-by: The FreeBSD Foundation
Sponsored-by: Rubicon Communications, LLC ("Netgate")
MFC after: 3 days
Reviewed-by: markj
Differential Revision: https://reviews.freebsd.org/D27413
72 lines
3.1 KiB
C
72 lines
3.1 KiB
C
/*-
|
|
* SPDX-License-Identifier: BSD-2-Clause-FreeBSD
|
|
*
|
|
* Copyright (c) 2005, Sam Leffler <sam@errno.com>
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice unmodified, this list of conditions, and the following
|
|
* disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
* $FreeBSD$
|
|
*/
|
|
#ifndef _SYS_FIRMWARE_H_
|
|
#define _SYS_FIRMWARE_H_
|
|
/*
|
|
* Loadable firmware support.
|
|
*
|
|
* The firmware abstraction provides an interface for loading firmware
|
|
* images into the kernel and making them available to clients.
|
|
*
|
|
* Firmware images are usually embedded in kernel loadable modules that can
|
|
* be loaded on-demand or pre-loaded as desired. Modules may contain
|
|
* one or more firmware images that are stored as opaque data arrays
|
|
* and registered with a unique string name. Clients request
|
|
* firmware by name, and are returned a struct firmware * below on success.
|
|
* The kernel keeps track of references to firmware images to allow/prevent
|
|
* module/data unload.
|
|
*
|
|
* When multiple images are stored in one module, the first image is
|
|
* treated as the master with the other images holding references
|
|
* to it. This means that to unload the module each dependent/subimage
|
|
* must first have its references removed.
|
|
* In order for automatic loading to work, the master image must have
|
|
* the same name as the module it is embedded into.
|
|
*/
|
|
struct firmware {
|
|
const char *name; /* system-wide name */
|
|
const void *data; /* location of image */
|
|
size_t datasize; /* size of image in bytes */
|
|
unsigned int version; /* version of the image */
|
|
};
|
|
|
|
const struct firmware *firmware_register(const char *,
|
|
const void *, size_t, unsigned int, const struct firmware *);
|
|
int firmware_unregister(const char *);
|
|
|
|
#define FIRMWARE_GET_NOWARN 0x0001 /* Do not warn if firmware not found. */
|
|
const struct firmware *firmware_get_flags(const char *, uint32_t flags);
|
|
const struct firmware *firmware_get(const char *);
|
|
|
|
#define FIRMWARE_UNLOAD 0x0001 /* unload if unreferenced */
|
|
void firmware_put(const struct firmware *, int);
|
|
|
|
#endif /* _SYS_FIRMWARE_H_ */
|