docs/54691: [PATCH] provide man pages for the kernel MI pmap subsystem

[Bruce M Simpson]

Here's an additional last minute diff to clarify exactly
which APIs the MD pmap subsystems are expected to implement.

juli mallett also suggested implementing a 'C' arch framework
containing stubs and basic state to illustrate how a new arch might
be ported, but this is a bit far off right now. 

BMS
-------------- next part --------------
--- pmap.9.orig	Mon Jul 21 08:55:35 2003
+++ pmap.9	Mon Jul 21 09:00:17 2003
@@ -48,6 +48,42 @@
 .Nm
 is responsible for managing hardware-dependent objects such as page tables,
 address maps, TLBs, et cetera.
+.Sh INTERFACE
+Machine-dependent code must implement the following APIs:
+.Pp
+.Fn pmap_activate ,
+.Fn pmap_addr_hint ,
+.Fn pmap_change_wiring ,
+.Fn pmap_clear_modify ,
+.Fn pmap_clear_reference ,
+.Fn pmap_copy ,
+.Fn pmap_copy_page ,
+.Fn pmap_enter ,
+.Fn pmap_extract ,
+.Fn pmap_growkernel ,
+.Fn pmap_init ,
+.Fn pmap_init2 ,
+.Fn pmap_is_modified ,
+.Fn pmap_map ,
+.Fn pmap_mincore ,
+.Fn pmap_object_init_pt ,
+.Fn pmap_page_exists_quick ,
+.Fn pmap_page_protect ,
+.Fn pmap_pinit ,
+.Fn pmap_pinit0 ,
+.Fn pmap_pinit2 ,
+.Fn pmap_prefault ,
+.Fn pmap_protect ,
+.Fn pmap_qenter ,
+.Fn pmap_qremove ,
+.Fn pmap_release ,
+.Fn pmap_remove ,
+.Fn pmap_remove_all ,
+.Fn pmap_remove_pages ,
+.Fn pmap_ts_modified ,
+.Fn pmap_zero_area ,
+.Fn pmap_zero_page ,
+.Fn pmap_zero_idle .
 .Pp
 Machine-dependent code must provide the header file
 .Em <machine/pmap.h> .