Add procstat_getauxv function to retrieve a process auxiliary vector.

MFC after:	1 month

1 files changed, 26 insertions, 0 deletions

diff --git a/lib/libprocstat/libprocstat.3 b/lib/libprocstat/libprocstat.3
index e1dc987..5a425e7 100644
--- a/lib/libprocstat/libprocstat.3
+++ b/lib/libprocstat/libprocstat.3
@@ -33,6 +33,7 @@
 .Nm procstat_open_sysctl ,
 .Nm procstat_close ,
 .Nm procstat_getargv ,
+.Nm procstat_getauxv ,
 .Nm procstat_getenvv ,
 .Nm procstat_getfiles ,
 .Nm procstat_getgroups ,
@@ -42,6 +43,7 @@
 .Nm procstat_getumask ,
 .Nm procstat_getvmmap ,
 .Nm procstat_freeargv ,
+.Nm procstat_freeauxv ,
 .Nm procstat_freeenvv ,
 .Nm procstat_freefiles ,
 .Nm procstat_freegroups ,
@@ -67,6 +69,11 @@
 .Fa "struct procstat *procstat"
 .Fc
 .Ft void
+.Fo procstat_freeauxv
+.Fa "struct procstat *procstat"
+.Fa "Elf_Auxinfo *auxv"
+.Fc
+.Ft void
 .Fo procstat_freeenvv
 .Fa "struct procstat *procstat"
 .Fc
@@ -129,6 +136,12 @@
 .Fa "size_t nchr"
 .Fa "char *errbuf"
 .Fc
+.Ft "Elf_Auxinfo *"
+.Fo procstat_getauxv
+.Fa "struct procstat *procstat"
+.Fa "struct kinfo_proc *kp"
+.Fa "unsigned int *count"
+.Fc
 .Ft "char **"
 .Fo procstat_getenvv
 .Fa "struct procstat *procstat"
@@ -321,6 +334,19 @@ The caller may free the allocated memory with a subsequent
 function call.
 .Pp
 The
+.Fn procstat_getauxv
+function gets a pointer to the
+.Vt procstat
+structure, a pointer to
+.Vt kinfo_proc
+structure, and returns the auxiliary vector as a dynamically allocated array of
+.Vt Elf_Auxinfo
+elements.
+The caller is responsible to free the allocated memory with a subsequent
+.Fn procstat_freeauxv
+function call.
+.Pp
+The
 .Fn procstat_getfiles
 function gets a pointer to the
 .Vt procstat