1 files changed, 63 insertions, 0 deletions
diff --git a/misc/man9ossddk/ossddk_adev_set_label.9ossddk b/misc/man9ossddk/ossddk_adev_set_label.9ossddk
new file mode 100644
index 0000000..a939ac9
--- /dev/null
+++ b/misc/man9ossddk/ossddk_adev_set_label.9ossddk
@@ -0,0 +1,63 @@
+'\" te
+.\"  Copyright (c) 2005, 4Front Technologies 2005\&.
+.TH ossddk_adev_set_label 9ossddk "12 Sep 2005" "SunOS 5.10" "OSS DDK Services"
+.SH "NAME"
+ossddk_adev_set_label \- Assign a label to an audio stream
+.PP
+.SH "SYNOPSIS"
+.nf
+#include <sys/soundcard.h>
+.LP
+#include <sys/ossddk/ossddk.h>
+.fi
+.LP
+\fBvoid\fR ossddk_adev_set_label(\fBint \fIdev\fP, \fBchar *\fIlabel\fP);
+.PP
+.SH "INTERFACE LEVEL"
+.PP
+Open Sound System specific (OSS 4.0 DDK)\&.
+.PP
+.SH "ARGUMENTS"
+.PP
+.sp
+.ne 2
+.mk
+\fB\fIdev\fR
+.in +16n
+.rt
+OSS device number.
+.in -16n
+.sp
+.ne 2
+.mk
+\fB\fIlabel\fR
+.in +16n
+.rt
+A pointer to a character string containing 0 to 15 characters. An empty string
+means there is no label.
+.in -16n
+.PP
+.SH "DESCRIPTION"
+.PP
+Stream labels are short (up to 15 character) mnemonic names that the \fIsource\fR of the 
+stream can set. ossddk_adev_set_label assigns a label to an audio stream. The driver
+can set the label to an recording stream when this information is available from the
+device. For example a driver for a tape recorder or a digital audio link may obtain
+the reel name from the device and pass it to the application recording from the
+device. Setting the label of an output stream doesn't make any sense.
+.PP
+It's very important that drivers set the label only if that information is really
+available from the device. It doesn't make any sense to assign any kind of dummy labels
+such as "Unknown" or "default".
+.PP
+The driver must not expect that \fIossddk_adev_get_label\fR returns the same label
+that the driver had previously set with \fIossddk_adev_set_label\fR. This is
+certainly not the case.
+.PP
+.SH "SEE ALSO"
+.PP
+\fIossddk_adev_get_label(9ossddk)\fR
+.LP
+\fIWriting Sound Device Drivers with OSS DDK\fR
+.LP
+\fIOpen Sound System Programmer's Guide\fR