Skip to contentSkip to conversation

High-res-timers part 6 (support-man) take 2

PATCH In review george anzinger 4 participants 7 messages Sep 28, 2002 – Sep 30, 2002 Documentation

lore
Share & tools
lore
#0 lore raw

PATCH 6/6 High-res-timers part 6 (support-man) take 2

The 4th, 5th, and 6th parts are support code and not really part of the kernel.

This part contains man pages for the new system calls.

The whole of this patch will create and populate the Documentation/high-res-timers/man directory. A make file is included to install the man pages.

Signature · 5 lines
George Anzinger   [email protected]
High-res-timers: 
http://sourceforge.net/projects/high-res-timers/
Preemption patch:
http://www.kernel.org/pub/linux/kernel/people/rml
Documentation/high-res-timers/man/Makefile +45 -0
diff -urP -I \$Id:.*Exp \$ -X /usr/src/patch.exclude linux-2.5.36-kb/Documentation/high-res-timers/man/Makefile linux/Documentation/high-res-timers/man/Makefile
@@ -0,0 +1,45 @@
+# Makefile: install high-res-timers man pages
+#
+# We attempt to find the "correct" directory for the man pages as follows:
+
+# If the enviroment variable MANPATH is defined and not null, use the first
+# entry in it.
+
+# Otherwise, if /etc/man.config exists, use the first MANPATH entry in it.
+# If both of these fail, print an error and quit.
+
+# If you want to override this to put the pages in directory foo use:
+# make MANPATH=foo
+
+# If you want to force it to use the /etc/man.config and you have a MANPATH use:
+# make MANPATH=
+
+# You may need to be root to run this make.
+
+all: man
+MANCONF = /etc/man.config
+MANPAGES = clock_getcpuclockid.3 clock_getres.3 clock_gettime.3 \
+	   clock_nanosleep.3 clock_settime.3 pthread_getcpuclockid.3 \
+	   timer_create.3 timer_delete.3 timer_getoverrun.3 \
+	   timer_gettime.3 timer_settime.3
+
+man: $(MANPAGES)
+	@ENVMANPATH=`echo $$MANPATH | sed -e "s/:.*//"` ;\
+	if [ "$$ENVMANPATH" = "" ] ; then \
+		if [ -e $(MANCONF) ] ; then \
+			MANDIR=`grep -w '^ *MANPATH' $(MANCONF) |sed -e 2,50d -e "s/ *MANPATH[^/]*//"` ; \
+		else \
+			MANDIR="" ; \
+		fi \
+	else \
+		MANDIR=$$ENVMANPATH ; \
+	fi  ; \
+	if [ -d $$MANDIR ] ; then \
+		echo "Installing POSIX timers man pages to >$$MANDIR/< ..."; \
+		cp $(MANPAGES) $$MANDIR && \
+		cd $$MANDIR && \
+		chmod 644 $(MANPAGES) && \
+		gzip -9 $(MANPAGES); \
+	else \
+		echo "error: directory >$$MANDIR< does not exist, create or use make MANPATH=<dir>!"; \
+	fi
Documentation/high-res-timers/man/clock_getcpuclockid.3 +74 -0

74 lines not on this page · raw message

Documentation/high-res-timers/man/clock_getres.3 +95 -0

95 lines not on this page · raw message

Documentation/high-res-timers/man/clock_gettime.3 +130 -0

130 lines not on this page · raw message

Documentation/high-res-timers/man/clock_nanosleep.3 +155 -0

155 lines not on this page · raw message

Documentation/high-res-timers/man/clock_settime.3 +100 -0

100 lines not on this page · raw message

Documentation/high-res-timers/man/pthread_getcpuclockid.3 +74 -0

74 lines not on this page · raw message

Documentation/high-res-timers/man/timer_create.3 +173 -0

173 lines not on this page · raw message

Documentation/high-res-timers/man/timer_delete.3 +77 -0

77 lines not on this page · raw message

Documentation/high-res-timers/man/timer_getoverrun.3 +83 -0

83 lines not on this page · raw message

Documentation/high-res-timers/man/timer_gettime.3 +77 -0

77 lines not on this page · raw message

Documentation/high-res-timers/man/timer_settime.3 +128 -0

128 lines not on this page · raw message

#1 lore raw
Quoted 2 lines · george anzinger

The 4th, 5th, and 6th parts are support code and not really part of the kernel.

So ...

Quoted 1 line

This part contains man pages for the new system calls.

... why are they here ?

http://freshmeat.net/projects/man-pages/

regards
john

Signature · 2 lines
"When your name is Winner, that's it. You don't need a nickname."
	- Loser Lane
#2 lore raw
Quoted 11 lines · John Levon
Quoted 2 lines · george anzinger

The 4th, 5th, and 6th parts are support code and not really part of the kernel.

So ...

Quoted 1 line

This part contains man pages for the new system calls.

... why are they here ?

So they are easy to find :)

Quoted 13 lines

http://freshmeat.net/projects/man-pages/

regards
john
--
"When your name is Winner, that's it. You don't need a nickname."
- Loser Lane
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/

Signature · 5 lines
George Anzinger   [email protected]
High-res-timers: 
http://sourceforge.net/projects/high-res-timers/
Preemption patch:
http://www.kernel.org/pub/linux/kernel/people/rml
#3 lore raw
In reply to John Levon

On Sat, 28 Sep 2002, John Levon wrote:

| On Sat, Sep 28, 2002 at 10:32:08AM -0700, george anzinger wrote:
|
| > The 4th, 5th, and 6th parts are support code and not really
| > part of the kernel.
|
| So ...
|
| > This part contains man pages for the new system calls.
|
| ... why are they here ?
|
| http://freshmeat.net/projects/man-pages/

I agree, please let's not clutter the kernel tree.

Signature · 1 line
~Randy
#4 lore raw
Quoted 16 lines · Randy.Dunlap

On Sat, 28 Sep 2002, John Levon wrote:

| On Sat, Sep 28, 2002 at 10:32:08AM -0700, george anzinger wrote:
|
| > The 4th, 5th, and 6th parts are support code and not really
| > part of the kernel.
|
| So ...
|
| > This part contains man pages for the new system calls.
|
| ... why are they here ?
|
| http://freshmeat.net/projects/man-pages/
Quoted 1 line

I agree, please let's not clutter the kernel tree.

Oh, I agree also. I don't think any of the high-res-timers support patches belong in the tree. For testing and verifying the system calls, however, it is nice to have them. It is easy to do the patch and then move the whole directory as this is the only thing in it.

I might suggest, however, that we should have a regression test set for the kernel "somewhere". Does such a thing exist? I haven't seen it, but then I have yet to see a great number of things ;)

Signature · 5 lines
George Anzinger   [email protected]
High-res-timers: 
http://sourceforge.net/projects/high-res-timers/
Preemption patch:
http://www.kernel.org/pub/linux/kernel/people/rml
#5 lore raw

On Mon, 30 Sep 2002, george anzinger wrote:

| "Randy.Dunlap" wrote:
| >
| > On Sat, 28 Sep 2002, John Levon wrote:
| >
| > | On Sat, Sep 28, 2002 at 10:32:08AM -0700, george anzinger wrote:
| > |
| > | > The 4th, 5th, and 6th parts are support code and not really
| > | > part of the kernel.
| > |
| > | So ...
| > |
| > | > This part contains man pages for the new system calls.
| > |
| > | ... why are they here ?
| > |
| > | http://freshmeat.net/projects/man-pages/
| >
| > I agree, please let's not clutter the kernel tree.
|
| Oh, I agree also.  I don't think any of the high-res-timers
| support patches belong in the tree.  For testing and
| verifying the system calls, however, it is nice to have
| them.  It is easy to do the patch and then move the whole
| directory as this is the only thing in it.
|
| I might suggest, however, that we should have a regression
| test set for the kernel "somewhere".  Does such a thing
| exist?  I haven't seen it, but then I have yet to see a
| great number of things ;)

I believe that IBM's LTP project does regression testing on 2.5.x kernels. That's more for things like compile/build and syscall correctness IIRC. Not so much as performance (regression) testing.

Signature · 1 line
~Randy
#6 lore raw
In reply to george anzinger
Quoted 4 lines · george anzinger

I might suggest, however, that we should have a regression test set for the kernel "somewhere". Does such a thing exist? I haven't seen it, but then I have yet to see a great number of things ;)

http://ltp.sourceforge.net/

regards
john

Signature · 2 lines
"When your name is Winner, that's it. You don't need a nickname."
	- Loser Lane