PERFORCE change 98080 for review

[Christian S.J. Peron]

http://perforce.freebsd.org/chv.cgi?CH=98080

Change 98080 by csjp at csjp_xor on 2006/05/29 17:06:58

	Add a note to the audit_submit man page informing users that how the
	terminal ID portion of the subject token will be set.

Affected files ...

.. //depot/projects/trustedbsd/openbsm/libbsm/audit_submit.3#7 edit

Differences ...

==== //depot/projects/trustedbsd/openbsm/libbsm/audit_submit.3#7 (text+ko) ====

@@ -26,7 +26,7 @@
 .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
 .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
-.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/audit_submit.3#6 $
+.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/audit_submit.3#7 $
 .Dd April 11, 2006
 .Dt audit_submit 3
 .Os
@@ -65,6 +65,18 @@
 If
 .Fa format
 is NULL, then no text token is created in the audit record.
+.Pp
+It should be noted that
+.Nm
+assumes that
+.Xr setaudit 2 ,
+or
+.Xr setaudit_addr 2 
+has already been called. As a direct result, the terminal ID for the
+subject will be retrieved from the kernel via
+.Xr getaudit 2 ,
+or
+.Xr getaudit_addr 2 .
 .Sh EXAMPLES
 .Bd -literal -offset indent
 #include <bsm/audit.h>
@@ -96,6 +108,7 @@
 .Ed
 .Sh SEE ALSO
 .Xr auditon 2 ,
+.Xr getaudit 2 ,
 .Xr libbsm 3 ,
 .Xr stdarg 3
 .Sh HISTORY