pcu.git  about / heads / tags
page cache utilities for Linux
blob 78114f2366bd8f5530fb54038543f9a24bd835fa 1474 bytes (raw)
$ git show HEAD:INSTALL	# shows this blob on the CLI

 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
 
Installing page cache utilities
===============================

Dependencies
------------

These utilities are dependent on the [posix_fadvise(2)][1] and
[mincore(2)][2] system calls.

[pcu-fadvise(1)](pcu-fadvise.1.html) needs a kernel that supports the
[posix_fadvise(2)][1] and syscall and C library support.  For GNU/Linux
systems, this means you'll need a kernel newer than 2.5.60 and the GNU C
library 2.2 or later.

[pcu-mincore(1)](pcu-mincore.1.html) should work on most somewhat-modern
UNIX/UNIX-like kernels that support the [mincore(2)][2] system call.
While the [mincore(2)][2] system call is not specified by current
versions of POSIX, it is fairly common.

Standard build tools such as a C compiler, GNU make, install are required.

If you wish to build and install the manpages or HTML documentation,
you'll also need [Pandoc](http://johnmacfarlane.net/pandoc/).  The
documentation is otherwise viewable as Markdown.

Instructions
------------

To install executables into your home directory in ~/bin:

    $ make
    $ make install

To install executables globally in /usr/local/bin:

    $ make ; # as yourself
    # make install prefix=/usr/local/bin ; # as root

All pcu-* executables are relocatable and have no dependencies outside
of the system C library and kernel support for the syscalls they need.

[1]: http://opengroup.org/onlinepubs/009695399/functions/posix_fadvise.html
[2]: http://kernel.org/doc/man-pages/online/pages/man2/mincore.2.html

git clone https://yhbt.net/pcu.git