Index: share/man/man4/sndstat.4 =================================================================== --- share/man/man4/sndstat.4 +++ share/man/man4/sndstat.4 @@ -47,10 +47,11 @@ .Sh DESCRIPTION The ioctl interface provided by .Pa /dev/sndstat -device allows callers to enumeration PCM audio devices available for use. +device allows callers to enumerate PCM audio devices available for use. In +other words, it provides means to get the list of all audio devices available +to the system. .Sh IOCTLS -For all ioctls requiring data exchange between the subsystem and callers, -the following structures are used to describe a serialized nvlist: +For all ioctl calls use the following structure: .Bd -literal -offset indent struct sndstioc_nv_arg { size_t nbytes; @@ -58,7 +59,10 @@ }; .Ed .Pp -Here is an example of an nvlist, with explanations of the common fields: +The buf from above will be filled with raw bytes. Those bytes can be unpacked +into nvlist (array like structure). + +Here is an example of nvlist object with explanations of the common fields: .Bd -literal -offset indent dsps (NVLIST ARRAY): 1 from_user (BOOL): FALSE