This file is indexed.

/usr/share/doc/libifp4/README is in libifp4 1.0.0.2-5ubuntu1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
-------
License
-------

Copyright (C) Geoff Oakham, 2004; <oakhamg@users.sourceforge.net>

This driver is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; only version 2 of the License.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License in the file
"COPYING"; if not, write to the Free Software Foundation, Inc., 59 Temple Place
- Suite 330, Boston, MA  02111-1307, USA.

-------------
License-notes
-------------

If someone ports libifp to the FreeBSD kernel, I would serriously consider
dual-licensing it.

-------
Summary
-------

libifp is a general-purpose library-driver for iRiver's iFP (flash-based)
portable audio players.

	http://ifp-driver.sourceforge.net/libifp/

------------
Requirements
------------

This driver has been reported to work with models iFP1xx, 3xx, 5xx, 7xx, 8xx, 9xx and N10.

userspace library:

	-libusb
	-gcc 2.95+ (and related dev tools)
	-POSIX run-time environment

linux kernel module:

	-linux 2.6.x+
	-gcc 2.95+ (and related dev tools)
	-linux kernel sourcecode [enough to compile modules]
	-a filesystem that supports symlinks (for compilation)

------------------
Build Instructions
------------------

userspace library:
	1. tar -xzf libifp-0.1.2.3.tar.gz
	2. cd libifp-0.1.2.3
	3. ./configure --prefix=/tmp/foo
	4a make
	4b make test 		(optional)
	5. make install

	In your own project, add "-I/tmp/foo/include" to your compiler flags
	and "-L/tmp/foo/lib -lifp -lusb" to your linker flags.  (Add another -L
	argument if the linker need help finding libusb.)

linux kernel module:
	1. tar -xzf libifp-0.1.2.3.tar.gz
	2. cd libifp-0.1.2.3
	3. ./configure --with-kmodule=path/to/kernel/source
	4. make
	5. make install

-----
Usage
-----

Read ifp.h(3) (packaged in docs/man), and the code in 'examples'.

notes:
	* libifp is neither threadsafe nor thread-unsafe; it's up to the
	  caller to provide sychronization.

	  (Note: the normal [userland] shared library version of libifp uses
	  libusb.  If thread safety is important to you, make sure libusb
	  itself is threadsafe.. because I haven't.)

	* libusb must be initialized by calling usb_init() before using
	  libifp.  (When using the userspace library.)

---------------
Troubleshooting
---------------

	- examine the debug messages from stderr or the kernel log.
	- reset the device (or unplug it + turn it off) and try again.

	If you still can't get it working, please email me with your
		-debug messages
		-the filenames involved
		-kernel or libusb version
		-the libifp version
		-iFP model number
		-iFP firmware version
		-your favourite colour
	
	If possible, please also send me the status string returned by ifp_device_info()
	which looks something like this:

		model IFP-007T, firmware 1.14, battery =[####], delta 1.8.4.42

	(Note to application developers: it would be helpful if this string is available
	from the "about box" or another easy-to-access location.)

-------
Credits
-------

	Special thanks to Boris and Jim who were the first brave souls to try
	the first version--a kernel filesystem module.  Thanks to David who
	took the time to debug iFP8xx support and to the folks on
	#kernelnewbies who made helpful suggestions when I was stuck.  Everyone
	has been encouraging and helpful with their feedback, and is much
	appreciated.

	Lastly, thanks to Jordan who bought me the mp3 player.  You know how
	kids often enjoy playing with the box more than the toy inside?  Well,
	writing the driver has been a neat experience.. and the packaging came
	with top-grade bubblewrap. :)

------------
Bibliography
------------

	-Pavel Kriz and Jun Yamashiro, ifp-driver/ifp-line source code
	-ifp-driver mailing list, general discussion
	-Bovet & Cesati, "Understanding the Linux Kernel"