forked from Minki/linux
e3eea08e64
This commit affects comments (and in one case, whitespace) only. Throughout the IPA code, return statements are documented using "@Return:", whereas they should use "Return:" instead. Fix these mistakes. In function definitions, some parameters are missing their comment to describe them. And in structure definitions, some fields are missing their comment to describe them. Add these missing descriptions. Some arguments changed name and type along the way, but their descriptions were not updated (an endpoint pointer is now used in many places that previously used an endpoint ID). Fix these incorrect parameter descriptions. In the description for the ipa_clock structure, one field had a semicolon instead of a colon in its description. Fix this. Add a missing function description for ipa_gsi_endpoint_data_empty(). All of these issues were identified when building with "W=1". Signed-off-by: Alex Elder <elder@linaro.org> Signed-off-by: David S. Miller <davem@davemloft.net>
104 lines
2.3 KiB
C
104 lines
2.3 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
|
|
/* Copyright (c) 2012-2018, The Linux Foundation. All rights reserved.
|
|
* Copyright (C) 2019-2020 Linaro Ltd.
|
|
*/
|
|
#ifndef _IPA_TABLE_H_
|
|
#define _IPA_TABLE_H_
|
|
|
|
#include <linux/types.h>
|
|
|
|
struct ipa;
|
|
|
|
/* The size of a filter or route table entry */
|
|
#define IPA_TABLE_ENTRY_SIZE sizeof(__le64) /* Holds a physical address */
|
|
|
|
/* The maximum number of filter table entries (IPv4, IPv6; hashed or not) */
|
|
#define IPA_FILTER_COUNT_MAX 14
|
|
|
|
/* The maximum number of route table entries (IPv4, IPv6; hashed or not) */
|
|
#define IPA_ROUTE_COUNT_MAX 15
|
|
|
|
#ifdef IPA_VALIDATE
|
|
|
|
/**
|
|
* ipa_table_valid() - Validate route and filter table memory regions
|
|
* @ipa: IPA pointer
|
|
|
|
* Return: true if all regions are valid, false otherwise
|
|
*/
|
|
bool ipa_table_valid(struct ipa *ipa);
|
|
|
|
/**
|
|
* ipa_filter_map_valid() - Validate a filter table endpoint bitmap
|
|
* @ipa: IPA pointer
|
|
*
|
|
* Return: true if all regions are valid, false otherwise
|
|
*/
|
|
bool ipa_filter_map_valid(struct ipa *ipa, u32 filter_mask);
|
|
|
|
#else /* !IPA_VALIDATE */
|
|
|
|
static inline bool ipa_table_valid(struct ipa *ipa)
|
|
{
|
|
return true;
|
|
}
|
|
|
|
static inline bool ipa_filter_map_valid(struct ipa *ipa, u32 filter_mask)
|
|
{
|
|
return true;
|
|
}
|
|
|
|
#endif /* !IPA_VALIDATE */
|
|
|
|
/**
|
|
* ipa_table_reset() - Reset filter and route tables entries to "none"
|
|
* @ipa: IPA pointer
|
|
* @modem: Whether to reset modem or AP entries
|
|
*/
|
|
void ipa_table_reset(struct ipa *ipa, bool modem);
|
|
|
|
/**
|
|
* ipa_table_hash_flush() - Synchronize hashed filter and route updates
|
|
* @ipa: IPA pointer
|
|
*/
|
|
int ipa_table_hash_flush(struct ipa *ipa);
|
|
|
|
/**
|
|
* ipa_table_setup() - Set up filter and route tables
|
|
* @ipa: IPA pointer
|
|
*/
|
|
int ipa_table_setup(struct ipa *ipa);
|
|
|
|
/**
|
|
* ipa_table_teardown() - Inverse of ipa_table_setup()
|
|
* @ipa: IPA pointer
|
|
*/
|
|
void ipa_table_teardown(struct ipa *ipa);
|
|
|
|
/**
|
|
* ipa_table_config() - Configure filter and route tables
|
|
* @ipa: IPA pointer
|
|
*/
|
|
void ipa_table_config(struct ipa *ipa);
|
|
|
|
/**
|
|
* ipa_table_deconfig() - Inverse of ipa_table_config()
|
|
* @ipa: IPA pointer
|
|
*/
|
|
void ipa_table_deconfig(struct ipa *ipa);
|
|
|
|
/**
|
|
* ipa_table_init() - Do early initialization of filter and route tables
|
|
* @ipa: IPA pointer
|
|
*/
|
|
int ipa_table_init(struct ipa *ipa);
|
|
|
|
/**
|
|
* ipa_table_exit() - Inverse of ipa_table_init()
|
|
* @ipa: IPA pointer
|
|
*/
|
|
void ipa_table_exit(struct ipa *ipa);
|
|
|
|
#endif /* _IPA_TABLE_H_ */
|