linux/net/bluetooth/lib.c

/*
   BlueZ - Bluetooth protocol stack for Linux
   Copyright (C) 2000-2001 Qualcomm Incorporated

   Written 2000,2001 by Maxim Krasnyansky <[email protected]>

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License version 2 as
   published by the Free Software Foundation;

   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
   OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
   IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
   CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

   ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
   COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
   SOFTWARE IS DISCLAIMED.
*/

/* Bluetooth kernel library. */

#define pr_fmt(fmt) …

#include <linux/export.h>

#include <net/bluetooth/bluetooth.h>

/**
 * baswap() - Swaps the order of a bd address
 * @dst: Pointer to a bdaddr_t struct that will store the swapped
 * 		 bd address.
 * @src: Pointer to the bdaddr_t struct to be swapped.
 *
 * This function reverses the byte order of a Bluetooth device
 * address.
 */
void baswap(bdaddr_t *dst, const bdaddr_t *src)
{ … }
EXPORT_SYMBOL(…);

/**
 * bt_to_errno() - Bluetooth error codes to standard errno
 * @code: Bluetooth error code to be converted
 *
 * This function takes a Bluetooth error code as input and convets
 * it to an equivalent Unix/standard errno value.
 *
 * Return:
 *
 * If the bt error code is known, an equivalent Unix errno value
 * is returned.
 * If the given bt error code is not known, ENOSYS is returned.
 */
int bt_to_errno(__u16 code)
{ … }
EXPORT_SYMBOL(…);

/**
 * bt_status() - Standard errno value to Bluetooth error code
 * @err: Unix/standard errno value to be converted
 *
 * This function converts a standard/Unix errno value to an
 * equivalent Bluetooth error code.
 *
 * Return: Bluetooth error code.
 *
 * If the given errno is not found, 0x1f is returned by default
 * which indicates an unspecified error.
 * For err >= 0, no conversion is performed, and the same value
 * is immediately returned.
 */
__u8 bt_status(int err)
{ … }
EXPORT_SYMBOL(…);

/**
 * bt_info() - Log Bluetooth information message
 * @format: Message's format string
 */
void bt_info(const char *format, ...)
{ … }
EXPORT_SYMBOL(…);

/**
 * bt_warn() - Log Bluetooth warning message
 * @format: Message's format string
 */
void bt_warn(const char *format, ...)
{ … }
EXPORT_SYMBOL(…);

/**
 * bt_err() - Log Bluetooth error message
 * @format: Message's format string
 */
void bt_err(const char *format, ...)
{ … }
EXPORT_SYMBOL(…);

#ifdef CONFIG_BT_FEATURE_DEBUG
static bool debug_enable;

void bt_dbg_set(bool enable)
{
	debug_enable = enable;
}

bool bt_dbg_get(void)
{
	return debug_enable;
}

/**
 * bt_dbg() - Log Bluetooth debugging message
 * @format: Message's format string
 */
void bt_dbg(const char *format, ...)
{
	struct va_format vaf;
	va_list args;

	if (likely(!debug_enable))
		return;

	va_start(args, format);

	vaf.fmt = format;
	vaf.va = &args;

	printk(KERN_DEBUG pr_fmt("%pV"), &vaf);

	va_end(args);
}
EXPORT_SYMBOL(bt_dbg);
#endif

/**
 * bt_warn_ratelimited() - Log rate-limited Bluetooth warning message
 * @format: Message's format string
 *
 * This functions works like bt_warn, but it uses rate limiting
 * to prevent the message from being logged too often.
 */
void bt_warn_ratelimited(const char *format, ...)
{ … }
EXPORT_SYMBOL(…);

/**
 * bt_err_ratelimited() - Log rate-limited Bluetooth error message
 * @format: Message's format string
 *
 * This functions works like bt_err, but it uses rate limiting
 * to prevent the message from being logged too often.
 */
void bt_err_ratelimited(const char *format, ...)
{ … }
EXPORT_SYMBOL(…);