This patch adds a basic manual page for the pagesize utility.
Signed-off-by: Mel Gorman <[EMAIL PROTECTED]>
---
Makefile | 6 +++++
man/pagesize.1 | 57 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 63 insertions(+), 0 deletions(-)
create mode 100644 man/pagesize.1
diff --git a/Makefile b/Makefile
index a89e2c2..d4bec00 100644
--- a/Makefile
+++ b/Makefile
@@ -6,6 +6,7 @@ INSTALL_OBJ_LIBS = libhugetlbfs.so libhugetlbfs.a
BIN_OBJ_DIR=obj
INSTALL_BIN = hugectl hugeedit hpoolcfg pagesize
INSTALL_HEADERS = hugetlbfs.h
+INSTALL_MAN1 = pagesize.1
INSTALL_MAN3 = get_huge_pages.3 gethugepagesizes.3 getpagesizes.3
INSTALL_MAN7 = libhugetlbfs.7
INSTALL_MAN8 = hugectl.8 hugeedit.8
@@ -111,6 +112,7 @@ LDSCRIPTDIR = $(PREFIX)/share/libhugetlbfs/ldscripts
BINDIR = $(PREFIX)/share/libhugetlbfs
EXEDIR = $(PREFIX)/bin
DOCDIR = $(PREFIX)/share/doc/libhugetlbfs
+MANDIR1 = $(PREFIX)/man/man1
MANDIR3 = $(PREFIX)/man/man3
MANDIR7 = $(PREFIX)/man/man7
MANDIR8 = $(PREFIX)/man/man8
@@ -323,6 +325,10 @@ install: libs tools $(OBJDIRS:%=%/install)
$(INSTALL_OBJSCRIPT:%=objscript.%)
for x in $(INSTALL_OBJSCRIPT); do \
$(INSTALL) -m 755 objscript.$$x $(DESTDIR)$(BINDIR)/$$x; done
@$(VECHO) INSTALLMAN $(DESTDIR)manX
+ for x in $(INSTALL_MAN1); do \
+ $(INSTALL) -m 444 man/$$x $(DESTDIR)$(MANDIR1); \
+ gzip -f $(DESTDIR)$(MANDIR1)/$$x; \
+ done
for x in $(INSTALL_MAN3); do \
$(INSTALL) -m 444 man/$$x $(DESTDIR)$(MANDIR3); \
gzip -f $(DESTDIR)$(MANDIR3)/$$x; \
diff --git a/man/pagesize.1 b/man/pagesize.1
new file mode 100644
index 0000000..0476365
--- /dev/null
+++ b/man/pagesize.1
@@ -0,0 +1,57 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH PAGESIZE 1 "October 10, 2008"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+pagesize \- Print supported system page sizes
+.SH SYNOPSIS
+.B pagesize [options]
+.SH DESCRIPTION
+
+The pagesize utility prints the page sizes of a page of memory in bytes,
+as returned by getpagesizes(3). This is useful when creating portable shell
+scripts, configuring huge page pools with hugeadm or launching applications
+to use huge pages with hugectl.
+
+If no parameters are specified, \fBpagesize\fP prints the system base page
+size as returned by \fBgetpagesize()\fP. The following parameters affect
+what other pagesizes are displayed.
+
+.TP
+.B --huge-only, -H
+
+Display all huge pages supported by the system as returned by
+\fBgethugepagesizes()\fP.
+
+.TP
+.B --all, -a
+
+Display all page sizes supported by the system.
+
+.SH SEE ALSO
+.I oprofile(1),
+.I getpagesize(2),
+.I getpagesizes(3),
+.I gethugepagesizes(3),
+.I hugectl(7),
+.I hugeadm(7),
+.I libhugetlbfs(7)
+
+.br
+.SH AUTHORS
+libhugetlbfs was written by various people on the libhugetlbfs-devel
+mailing list.
+
--
1.5.6.5
-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Libhugetlbfs-devel mailing list
Libhugetlbfs-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/libhugetlbfs-devel
