/*
 * rational fractions
 *
 * Copyright (C) 2009 emlix GmbH, Oskar Schirmer <oskar@scara.com>
 *
 * helper functions when coping with rational numbers
 */

#include <linux/rational.h>
#include <linux/compiler.h>
#include <linux/export.h>

/*
 * calculate best rational approximation for a given fraction
 * taking into account restricted register size, e.g. to find
 * appropriate values for a pll with 5 bit denominator and
 * 8 bit numerator register fields, trying to set up with a
 * frequency ratio of 3.1415, one would say:
 *
 * rational_best_approximation(31415, 10000,
 *		(1 << 8) - 1, (1 << 5) - 1, &n, &d);
 *
 * you may look at given_numerator as a fixed point number,
 * with the fractional part size described in given_denominator.
 *
 * for theoretical background, see:
 * http://en.wikipedia.org/wiki/Continued_fraction
 */

void rational_best_approximation(
	unsigned long given_numerator, unsigned long given_denominator,
	unsigned long max_numerator, unsigned long max_denominator,
	unsigned long *best_numerator, unsigned long *best_denominator)
{
	unsigned long n, d, n0, d0, n1, d1;
	n = given_numerator;
	d = given_denominator;
	n0 = d1 = 0;
	n1 = d0 = 1;
	for (;;) {
		unsigned long t, a;
		if ((n1 > max_numerator) || (d1 > max_denominator)) {
			n1 = n0;
			d1 = d0;
			break;
		}
		if (d == 0)
			break;
		t = d;
		a = n / d;
		d = n % d;
		n = t;
		t = n0 + a * n1;
		n0 = n1;
		n1 = t;
		t = d0 + a * d1;
		d0 = d1;
		d1 = t;
	}
	*best_numerator = n1;
	*best_denominator = d1;
}

EXPORT_SYMBOL(rational_best_approximation);
ref='/cgit.cgi/linux/net-next.git/refs/?id=868c97a846a73e937d835b09b8c885a69df50ec8'>refs</a><a href='/cgit.cgi/linux/net-next.git/log/Documentation/mtd'>log</a><a href='/cgit.cgi/linux/net-next.git/tree/Documentation/mtd?id=868c97a846a73e937d835b09b8c885a69df50ec8'>tree</a><a class='active' href='/cgit.cgi/linux/net-next.git/commit/Documentation/mtd?id=868c97a846a73e937d835b09b8c885a69df50ec8'>commit</a><a href='/cgit.cgi/linux/net-next.git/diff/Documentation/mtd?id=868c97a846a73e937d835b09b8c885a69df50ec8'>diff</a></td><td class='form'><form class='right' method='get' action='/cgit.cgi/linux/net-next.git/log/Documentation/mtd'>
<input type='hidden' name='id' value='868c97a846a73e937d835b09b8c885a69df50ec8'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/cgit.cgi/linux/net-next.git/commit/?id=868c97a846a73e937d835b09b8c885a69df50ec8'>root</a>/<a href='/cgit.cgi/linux/net-next.git/commit/Documentation?id=868c97a846a73e937d835b09b8c885a69df50ec8'>Documentation</a>/<a href='/cgit.cgi/linux/net-next.git/commit/Documentation/mtd?id=868c97a846a73e937d835b09b8c885a69df50ec8'>mtd</a></div><div class='content'><div class='cgit-panel'><b>diff options</b><form method='get'><input type='hidden' name='id' value='868c97a846a73e937d835b09b8c885a69df50ec8'/><table><tr><td colspan='2'/></tr><tr><td class='label'>context:</td><td class='ctrl'><select name='context' onchange='this.form.submit();'><option value='1'>1</option><option value='2'>2</option><option value='3' selected='selected'>3</option><option value='4'>4</option><option value='5'>5</option><option value='6'>6</option><option value='7'>7</option><option value='8'>8</option><option value='9'>9</option><option value='10'>10</option><option value='15'>15</option><option value='20'>20</option><option value='25'>25</option><option value='30'>30</option><option value='35'>35</option><option value='40'>40</option></select></td></tr><tr><td class='label'>space:</td><td class='ctrl'><select name='ignorews' onchange='this.form.submit();'><option value='0' selected='selected'>include</option><option value='1'>ignore</option></select></td></tr><tr><td class='label'>mode:</td><td class='ctrl'><select name='dt' onchange='this.form.submit();'><option value='0' selected='selected'>unified</option><option value='1'>ssdiff</option><option value='2'>stat only</option></select></td></tr><tr><td/><td class='ctrl'><noscript><input type='submit' value='reload'/></noscript></td></tr></table></form></div><table summary='commit info' class='commit-info'>
<tr><th>author</th><td>Daniel Vetter &lt;daniel.vetter@ffwll.ch&gt;</td><td class='right'>2016-12-09 19:53:05 +0100</td></tr>
<tr><th>committer</th><td>Jonathan Corbet &lt;corbet@lwn.net&gt;</td><td class='right'>2016-12-11 13:37:55 -0700</td></tr>
<tr><th>commit</th><td colspan='2' class='oid'><a href='/cgit.cgi/linux/net-next.git/commit/Documentation/mtd?id=868c97a846a73e937d835b09b8c885a69df50ec8'>868c97a846a73e937d835b09b8c885a69df50ec8</a> (<a href='/cgit.cgi/linux/net-next.git/patch/Documentation/mtd?id=868c97a846a73e937d835b09b8c885a69df50ec8'>patch</a>)</td></tr>
<tr><th>tree</th><td colspan='2' class='oid'><a href='/cgit.cgi/linux/net-next.git/tree/?id=868c97a846a73e937d835b09b8c885a69df50ec8'>9cdc05e799d117ac71b29d0958ee3dc65b8d539d</a> /<a href='/cgit.cgi/linux/net-next.git/tree/Documentation/mtd?id=868c97a846a73e937d835b09b8c885a69df50ec8'>Documentation/mtd</a></td></tr>
<tr><th>parent</th><td colspan='2' class='oid'><a href='/cgit.cgi/linux/net-next.git/commit/Documentation/mtd?id=9e22ff439fa2e1201b168c001683f275afd46258'>9e22ff439fa2e1201b168c001683f275afd46258</a> (<a href='/cgit.cgi/linux/net-next.git/diff/Documentation/mtd?id=868c97a846a73e937d835b09b8c885a69df50ec8&amp;id2=9e22ff439fa2e1201b168c001683f275afd46258'>diff</a>)</td></tr></table>
<div class='commit-subject'>dma-buf: Extract dma-buf.rst</div><div class='commit-msg'>Just prep work to polish and consolidate all the dma-buf related
documenation.

Unfortunately I didn't discover a way to both integrate this new file
into the overall toc while keeping it at the current place. Work
around that by moving it into the overall driver-api/index.rst.

Cc: linux-doc@vger.kernel.org
Cc: Jonathan Corbet &lt;corbet@lwn.net&gt;
Cc: Sumit Semwal &lt;sumit.semwal@linaro.org&gt;
Signed-off-by: Daniel Vetter &lt;daniel.vetter@intel.com&gt;
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;
</div><div class='diffstat-header'><a href='/cgit.cgi/linux/net-next.git/diff/?id=868c97a846a73e937d835b09b8c885a69df50ec8'>Diffstat</a> (limited to 'Documentation/mtd')</div><table summary='diffstat' class='diffstat'>