mirror of
				https://github.com/torvalds/linux.git
				synced 2025-11-04 02:30:34 +02:00 
			
		
		
		
	- The old driver statement has been added to the kernel docs.
 
   - We have a couple of new helper scripts.  find-unused-docs.sh from Sayli
     Karnic will point out kerneldoc comments that are not actually used in
     the documentation.  Jani Nikula's documentation-file-ref-check finds
     references to non-existing files.
 
   - A new ftrace document from Steve Rostedt.
 
   - Vinod Koul converted the dmaengine docs to RST
 
 Beyond that, it's mostly simple fixes.
 -----BEGIN PGP SIGNATURE-----
 
 iQIcBAABAgAGBQJaCK37AAoJEI3ONVYwIuV63nwQALeqzVwGqqTwiyRyMqgEwMQM
 je/6IurEwTHtyfwtW/mztCfNid1CLTiYZg7RET3/zlHjcUI/9VlV2dbBksGFgoQo
 muHGqhwTJjXYREwjK3FkzrGckRsVZKJgdzmZYgukCCY6Ir7IffwJKYaLOCZN1S/l
 4nBHQpt2nITo0WhdmZjaNRKOQxMA8nN5yGpOIl0neGE6ywIUMgauCCCHhxnOPVWg
 ant1HliS8WR8Tizqt9wQgLCvs5lvklsBFibZPO9LBTPG2Zy3HIO9kb+npUAh2MTl
 j0Wg39zzOFvVVErqErqUIwIuQ9IrfltHrEHYYoruTvDBXBiMKIcwApF+DS+H3WSp
 TnDu3Qif4llM5SZsZGvcjawXNnbck+7SYOe9cyqpylV3SWMWrEX1tbUv6zVuVk+7
 fencYBvEZgkJmWbjDeO/Z4S50STxRTzIxFwZgLft7g/RiHo9HvlubjjwQTqBFjxA
 fVkolN7h69MGkrD8TF19eapyujqSXaNYH0pFYo87JNOjLgYmezUHyvHd8YeZJL31
 Ll0h10HqSNVzJsjFolBMgrC3CcVjsEXdBufu0yVk45sAg9ZiMYOCpwa6Rtp+tfxa
 uIBf1LKzfWSa0ocKx7+sMJt0B/CXwU3AMtsbYGyDhFhR2r3cp1NWBHf5nisz9etD
 2Md9RDFAMLELZurewB9Q
 =H6ud
 -----END PGP SIGNATURE-----
Merge tag 'docs-4.15' of git://git.lwn.net/linux
Pull documentation updates from Jonathan Corbet:
 "A relatively calm cycle for the docs tree again.
  - The old driver statement has been added to the kernel docs.
  - We have a couple of new helper scripts. find-unused-docs.sh from
    Sayli Karnic will point out kerneldoc comments that are not actually
    used in the documentation. Jani Nikula's
    documentation-file-ref-check finds references to non-existing files.
  - A new ftrace document from Steve Rostedt.
  - Vinod Koul converted the dmaengine docs to RST
  Beyond that, it's mostly simple fixes.
  This set reaches outside of Documentation/ a bit more than most. In
  all cases, the changes are to comment docs, mostly from Randy, in
  places where there didn't seem to be anybody better to take them"
* tag 'docs-4.15' of git://git.lwn.net/linux: (52 commits)
  documentation: fb: update list of available compiled-in fonts
  MAINTAINERS: update DMAengine documentation location
  dmaengine: doc: ReSTize pxa_dma doc
  dmaengine: doc: ReSTize dmatest doc
  dmaengine: doc: ReSTize client API doc
  dmaengine: doc: ReSTize provider doc
  dmaengine: doc: Add ReST style dmaengine document
  ftrace/docs: Add documentation on how to use ftrace from within the kernel
  bug-hunting.rst: Fix an example and a typo in a Sphinx tag
  scripts: Add a script to find unused documentation
  samples: Convert timers to use timer_setup()
  documentation: kernel-api: add more info on bitmap functions
  Documentation: fix selftests related file refs
  Documentation: fix ref to power basic-pm-debugging
  Documentation: fix ref to trace stm content
  Documentation: fix ref to coccinelle content
  Documentation: fix ref to workqueue content
  Documentation: fix ref to sphinx/kerneldoc.py
  Documentation: fix locking rt-mutex doc refs
  docs: dev-tools: correct Coccinelle version number
  ...
		
	
			
		
			
				
	
	
		
			192 lines
		
	
	
	
		
			4.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			192 lines
		
	
	
	
		
			4.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
// SPDX-License-Identifier: GPL-2.0
 | 
						|
/*
 | 
						|
 * Copyright (C) 2003 Bernardo Innocenti <bernie@develer.com>
 | 
						|
 *
 | 
						|
 * Based on former do_div() implementation from asm-parisc/div64.h:
 | 
						|
 *	Copyright (C) 1999 Hewlett-Packard Co
 | 
						|
 *	Copyright (C) 1999 David Mosberger-Tang <davidm@hpl.hp.com>
 | 
						|
 *
 | 
						|
 *
 | 
						|
 * Generic C version of 64bit/32bit division and modulo, with
 | 
						|
 * 64bit result and 32bit remainder.
 | 
						|
 *
 | 
						|
 * The fast case for (n>>32 == 0) is handled inline by do_div(). 
 | 
						|
 *
 | 
						|
 * Code generated for this function might be very inefficient
 | 
						|
 * for some CPUs. __div64_32() can be overridden by linking arch-specific
 | 
						|
 * assembly versions such as arch/ppc/lib/div64.S and arch/sh/lib/div64.S
 | 
						|
 * or by defining a preprocessor macro in arch/include/asm/div64.h.
 | 
						|
 */
 | 
						|
 | 
						|
#include <linux/export.h>
 | 
						|
#include <linux/kernel.h>
 | 
						|
#include <linux/math64.h>
 | 
						|
 | 
						|
/* Not needed on 64bit architectures */
 | 
						|
#if BITS_PER_LONG == 32
 | 
						|
 | 
						|
#ifndef __div64_32
 | 
						|
uint32_t __attribute__((weak)) __div64_32(uint64_t *n, uint32_t base)
 | 
						|
{
 | 
						|
	uint64_t rem = *n;
 | 
						|
	uint64_t b = base;
 | 
						|
	uint64_t res, d = 1;
 | 
						|
	uint32_t high = rem >> 32;
 | 
						|
 | 
						|
	/* Reduce the thing a bit first */
 | 
						|
	res = 0;
 | 
						|
	if (high >= base) {
 | 
						|
		high /= base;
 | 
						|
		res = (uint64_t) high << 32;
 | 
						|
		rem -= (uint64_t) (high*base) << 32;
 | 
						|
	}
 | 
						|
 | 
						|
	while ((int64_t)b > 0 && b < rem) {
 | 
						|
		b = b+b;
 | 
						|
		d = d+d;
 | 
						|
	}
 | 
						|
 | 
						|
	do {
 | 
						|
		if (rem >= b) {
 | 
						|
			rem -= b;
 | 
						|
			res += d;
 | 
						|
		}
 | 
						|
		b >>= 1;
 | 
						|
		d >>= 1;
 | 
						|
	} while (d);
 | 
						|
 | 
						|
	*n = res;
 | 
						|
	return rem;
 | 
						|
}
 | 
						|
EXPORT_SYMBOL(__div64_32);
 | 
						|
#endif
 | 
						|
 | 
						|
/**
 | 
						|
 * div_s64_rem - signed 64bit divide with 64bit divisor and remainder
 | 
						|
 * @dividend:	64bit dividend
 | 
						|
 * @divisor:	64bit divisor
 | 
						|
 * @remainder:  64bit remainder
 | 
						|
 */
 | 
						|
#ifndef div_s64_rem
 | 
						|
s64 div_s64_rem(s64 dividend, s32 divisor, s32 *remainder)
 | 
						|
{
 | 
						|
	u64 quotient;
 | 
						|
 | 
						|
	if (dividend < 0) {
 | 
						|
		quotient = div_u64_rem(-dividend, abs(divisor), (u32 *)remainder);
 | 
						|
		*remainder = -*remainder;
 | 
						|
		if (divisor > 0)
 | 
						|
			quotient = -quotient;
 | 
						|
	} else {
 | 
						|
		quotient = div_u64_rem(dividend, abs(divisor), (u32 *)remainder);
 | 
						|
		if (divisor < 0)
 | 
						|
			quotient = -quotient;
 | 
						|
	}
 | 
						|
	return quotient;
 | 
						|
}
 | 
						|
EXPORT_SYMBOL(div_s64_rem);
 | 
						|
#endif
 | 
						|
 | 
						|
/**
 | 
						|
 * div64_u64_rem - unsigned 64bit divide with 64bit divisor and remainder
 | 
						|
 * @dividend:	64bit dividend
 | 
						|
 * @divisor:	64bit divisor
 | 
						|
 * @remainder:  64bit remainder
 | 
						|
 *
 | 
						|
 * This implementation is a comparable to algorithm used by div64_u64.
 | 
						|
 * But this operation, which includes math for calculating the remainder,
 | 
						|
 * is kept distinct to avoid slowing down the div64_u64 operation on 32bit
 | 
						|
 * systems.
 | 
						|
 */
 | 
						|
#ifndef div64_u64_rem
 | 
						|
u64 div64_u64_rem(u64 dividend, u64 divisor, u64 *remainder)
 | 
						|
{
 | 
						|
	u32 high = divisor >> 32;
 | 
						|
	u64 quot;
 | 
						|
 | 
						|
	if (high == 0) {
 | 
						|
		u32 rem32;
 | 
						|
		quot = div_u64_rem(dividend, divisor, &rem32);
 | 
						|
		*remainder = rem32;
 | 
						|
	} else {
 | 
						|
		int n = 1 + fls(high);
 | 
						|
		quot = div_u64(dividend >> n, divisor >> n);
 | 
						|
 | 
						|
		if (quot != 0)
 | 
						|
			quot--;
 | 
						|
 | 
						|
		*remainder = dividend - quot * divisor;
 | 
						|
		if (*remainder >= divisor) {
 | 
						|
			quot++;
 | 
						|
			*remainder -= divisor;
 | 
						|
		}
 | 
						|
	}
 | 
						|
 | 
						|
	return quot;
 | 
						|
}
 | 
						|
EXPORT_SYMBOL(div64_u64_rem);
 | 
						|
#endif
 | 
						|
 | 
						|
/**
 | 
						|
 * div64_u64 - unsigned 64bit divide with 64bit divisor
 | 
						|
 * @dividend:	64bit dividend
 | 
						|
 * @divisor:	64bit divisor
 | 
						|
 *
 | 
						|
 * This implementation is a modified version of the algorithm proposed
 | 
						|
 * by the book 'Hacker's Delight'.  The original source and full proof
 | 
						|
 * can be found here and is available for use without restriction.
 | 
						|
 *
 | 
						|
 * 'http://www.hackersdelight.org/hdcodetxt/divDouble.c.txt'
 | 
						|
 */
 | 
						|
#ifndef div64_u64
 | 
						|
u64 div64_u64(u64 dividend, u64 divisor)
 | 
						|
{
 | 
						|
	u32 high = divisor >> 32;
 | 
						|
	u64 quot;
 | 
						|
 | 
						|
	if (high == 0) {
 | 
						|
		quot = div_u64(dividend, divisor);
 | 
						|
	} else {
 | 
						|
		int n = 1 + fls(high);
 | 
						|
		quot = div_u64(dividend >> n, divisor >> n);
 | 
						|
 | 
						|
		if (quot != 0)
 | 
						|
			quot--;
 | 
						|
		if ((dividend - quot * divisor) >= divisor)
 | 
						|
			quot++;
 | 
						|
	}
 | 
						|
 | 
						|
	return quot;
 | 
						|
}
 | 
						|
EXPORT_SYMBOL(div64_u64);
 | 
						|
#endif
 | 
						|
 | 
						|
/**
 | 
						|
 * div64_s64 - signed 64bit divide with 64bit divisor
 | 
						|
 * @dividend:	64bit dividend
 | 
						|
 * @divisor:	64bit divisor
 | 
						|
 */
 | 
						|
#ifndef div64_s64
 | 
						|
s64 div64_s64(s64 dividend, s64 divisor)
 | 
						|
{
 | 
						|
	s64 quot, t;
 | 
						|
 | 
						|
	quot = div64_u64(abs(dividend), abs(divisor));
 | 
						|
	t = (dividend ^ divisor) >> 63;
 | 
						|
 | 
						|
	return (quot ^ t) - t;
 | 
						|
}
 | 
						|
EXPORT_SYMBOL(div64_s64);
 | 
						|
#endif
 | 
						|
 | 
						|
#endif /* BITS_PER_LONG == 32 */
 | 
						|
 | 
						|
/*
 | 
						|
 * Iterative div/mod for use when dividend is not expected to be much
 | 
						|
 * bigger than divisor.
 | 
						|
 */
 | 
						|
u32 iter_div_u64_rem(u64 dividend, u32 divisor, u64 *remainder)
 | 
						|
{
 | 
						|
	return __iter_div_u64_rem(dividend, divisor, remainder);
 | 
						|
}
 | 
						|
EXPORT_SYMBOL(iter_div_u64_rem);
 |