dma-mapping: mn10300: remove the obsolete and unnecessary DMA API comments

#include <asm/cache.h>

#include <asm/io.h>

/*

 * See Documentation/DMA-API.txt for the description of how the

 * following DMA API should work.

 */

extern void *dma_alloc_coherent(struct device *dev, size_t size,

				dma_addr_t *dma_handle, int flag);

#define dma_alloc_noncoherent(d, s, h, f) dma_alloc_coherent((d), (s), (h), (f))

#define dma_free_noncoherent(d, s, v, h)  dma_free_coherent((d), (s), (v), (h))

/*

 * Map a single buffer of the indicated size for DMA in streaming mode.  The

 * 32-bit bus address to use is returned.

 *

 * Once the device is given the dma address, the device owns this memory until

 * either pci_unmap_single or pci_dma_sync_single is performed.

 */

static inline

dma_addr_t dma_map_single(struct device *dev, void *ptr, size_t size,

			  enum dma_data_direction direction)

	return virt_to_bus(ptr);

}

/*

 * Unmap a single streaming mode DMA translation.  The dma_addr and size must

 * match what was provided for in a previous pci_map_single call.  All other

 * usages are undefined.

 *

 * After this call, reads by the cpu to the buffer are guarenteed to see

 * whatever the device wrote there.

 */

static inline

void dma_unmap_single(struct device *dev, dma_addr_t dma_addr, size_t size,

		      enum dma_data_direction direction)

	BUG_ON(direction == DMA_NONE);

}

/*

 * Map a set of buffers described by scatterlist in streaming mode for DMA.

 * This is the scather-gather version of the above pci_map_single interface.

 * Here the scatter gather list elements are each tagged with the appropriate

 * dma address and length.  They are obtained via sg_dma_{address,length}(SG).

 *

 * NOTE: An implementation may be able to use a smaller number of DMA

 *       address/length pairs than there are SG table elements.  (for example

 *       via virtual mapping capabilities) The routine returns the number of

 *       addr/length pairs actually used, at most nents.

 *

 * Device ownership issues as mentioned above for pci_map_single are the same

 * here.

 */

static inline

int dma_map_sg(struct device *dev, struct scatterlist *sglist, int nents,

	       enum dma_data_direction direction)

	return nents;

}

/*

 * Unmap a set of streaming mode DMA translations.

 * Again, cpu read rules concerning calls here are the same as for

 * pci_unmap_single() above.

 */

static inline

void dma_unmap_sg(struct device *dev, struct scatterlist *sg, int nhwentries,

		  enum dma_data_direction direction)

	BUG_ON(!valid_dma_direction(direction));

}

/*

 * pci_{map,unmap}_single_page maps a kernel page to a dma_addr_t. identical

 * to pci_map_single, but takes a struct page instead of a virtual address

 */

static inline

dma_addr_t dma_map_page(struct device *dev, struct page *page,

			unsigned long offset, size_t size,

	BUG_ON(direction == DMA_NONE);

}

/*

 * Make physical memory consistent for a single streaming mode DMA translation

 * after a transfer.

 *

 * If you perform a pci_map_single() but wish to interrogate the buffer using

 * the cpu, yet do not wish to teardown the PCI dma mapping, you must call this

 * function before doing so.  At the next point you give the PCI dma address

 * back to the card, the device again owns the buffer.

 */

static inline

void dma_sync_single_for_cpu(struct device *dev, dma_addr_t dma_handle,

			     size_t size, enum dma_data_direction direction)

}

/*

 * Make physical memory consistent for a set of streaming mode DMA translations

 * after a transfer.

 *

 * The same as pci_dma_sync_single but for a scatter-gather list, same rules

 * and usage.

 */

static inline

void dma_sync_sg_for_cpu(struct device *dev, struct scatterlist *sg,

			 int nelems, enum dma_data_direction direction)

	return 0;

}

/*

 * Return whether the given PCI device DMA address mask can be supported

 * properly.  For example, if your device can only drive the low 24-bits during

 * PCI bus mastering, then you would pass 0x00ffffff as the mask to this

 * function.

 */

static inline

int dma_supported(struct device *dev, u64 mask)

{