mirror of
https://github.com/torvalds/linux.git
synced 2024-11-28 23:21:31 +00:00
a08b9f2f22
The opening comment mark '/**' is used for highlighting the beginning of kernel-doc comments. There are files in sound/pci/ctxfi which follow this syntax in their file headers, i.e. start with '/**' like comments, which causes unexpected warnings from kernel-doc. E.g., running scripts/kernel-doc -none on sound/pci/ctxfi/ctresource.c causes this warning: "warning: wrong kernel-doc identifier on line: * Copyright (C) 2008, Creative Technology Ltd. All Rights Reserved." Similarly for other files too. Provide a simple fix by replacing the kernel-doc like comment syntax with general format, i.e. "/*", to prevent kernel-doc from parsing it. Signed-off-by: Aditya Srivastava <yashsri421@gmail.com> Acked-by: Randy Dunlap <rdunlap@infradead.org> Link: https://lore.kernel.org/r/20210317203932.23993-1-yashsri421@gmail.com Signed-off-by: Takashi Iwai <tiwai@suse.de>
61 lines
1.7 KiB
C
61 lines
1.7 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* Copyright (C) 2008, Creative Technology Ltd. All Rights Reserved.
|
|
*
|
|
* @File ctvmem.h
|
|
*
|
|
* @Brief
|
|
* This file contains the definition of virtual memory management object
|
|
* for card device.
|
|
*
|
|
* @Author Liu Chun
|
|
* @Date Mar 28 2008
|
|
*/
|
|
|
|
#ifndef CTVMEM_H
|
|
#define CTVMEM_H
|
|
|
|
#define CT_PTP_NUM 4 /* num of device page table pages */
|
|
|
|
#include <linux/mutex.h>
|
|
#include <linux/list.h>
|
|
#include <linux/pci.h>
|
|
#include <sound/memalloc.h>
|
|
|
|
/* The chip can handle the page table of 4k pages
|
|
* (emu20k1 can handle even 8k pages, but we don't use it right now)
|
|
*/
|
|
#define CT_PAGE_SIZE 4096
|
|
#define CT_PAGE_SHIFT 12
|
|
#define CT_PAGE_MASK (~(PAGE_SIZE - 1))
|
|
#define CT_PAGE_ALIGN(addr) ALIGN(addr, CT_PAGE_SIZE)
|
|
|
|
struct ct_vm_block {
|
|
unsigned int addr; /* starting logical addr of this block */
|
|
unsigned int size; /* size of this device virtual mem block */
|
|
struct list_head list;
|
|
};
|
|
|
|
struct snd_pcm_substream;
|
|
|
|
/* Virtual memory management object for card device */
|
|
struct ct_vm {
|
|
struct snd_dma_buffer ptp[CT_PTP_NUM]; /* Device page table pages */
|
|
unsigned int size; /* Available addr space in bytes */
|
|
struct list_head unused; /* List of unused blocks */
|
|
struct list_head used; /* List of used blocks */
|
|
struct mutex lock;
|
|
|
|
/* Map host addr (kmalloced/vmalloced) to device logical addr. */
|
|
struct ct_vm_block *(*map)(struct ct_vm *, struct snd_pcm_substream *,
|
|
int size);
|
|
/* Unmap device logical addr area. */
|
|
void (*unmap)(struct ct_vm *, struct ct_vm_block *block);
|
|
dma_addr_t (*get_ptp_phys)(struct ct_vm *vm, int index);
|
|
};
|
|
|
|
int ct_vm_create(struct ct_vm **rvm, struct pci_dev *pci);
|
|
void ct_vm_destroy(struct ct_vm *vm);
|
|
|
|
#endif /* CTVMEM_H */
|