svn commit: r309395 - stable/10/share/man/man9

[Julian Elischer]

Author: julian
Date: Fri Dec  2 06:27:14 2016
New Revision: 309395
URL: https://svnweb.freebsd.org/changeset/base/309395

Log:
  MFH: r297012
  
  Add a few details that make it easier to use this macro.
  
  Sponsored by:	Panzura inc

Modified:
  stable/10/share/man/man9/SYSCALL_MODULE.9
Directory Properties:
  stable/10/   (props changed)

Modified: stable/10/share/man/man9/SYSCALL_MODULE.9
==============================================================================
--- stable/10/share/man/man9/SYSCALL_MODULE.9	Fri Dec  2 06:15:59 2016	(r309394)
+++ stable/10/share/man/man9/SYSCALL_MODULE.9	Fri Dec  2 06:27:14 2016	(r309395)
@@ -57,6 +57,8 @@ A pointer to an
 which saves the offset in
 .Vt "struct sysent"
 where the syscall is allocated.
+If the location pointed to by offset holds a non 0 number it will be used if possible.
+If it holds 0 then one will be assigned.
 .It Fa new_sysent
 is a pointer to a structure that specifies the function implementing
 the syscall and the number of arguments this function needs (see
@@ -72,6 +74,17 @@ The argument passed to the callback func
 .Fa evh
 event handler when it is called.
 .El
+.Pp
+The syscall number assigned to the module can be retrieved using the
+.Xr modstat 3
+and
+.Xr modfind 3
+library functions in libc.
+The MACRO
+.Fn SYSCALL_MODULE_HELPER
+includes 
+.Fn SYSCALL_MODULE
+and much of its boilerplate code.
 .Sh EXAMPLES
 A minimal example for a syscall module can be found in
 .Pa /usr/share/examples/kld/syscall/module/syscall.c .