Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 26 Apr 2001 00:44:36 -0400 (EDT)
From:      "Andrew R. Reiter" <arr@watson.org>
To:        freebsd-doc@FreeBSD.org
Subject:   uprintf.9
Message-ID:  <Pine.NEB.3.96L.1010426004219.47696A-200000@fledge.watson.org>

next in thread | raw e-mail | index | archive | help

[-- Attachment #1 --]
hi,

I was going to write this alittle over a year ago, now, but I got
lazy^H^H^H^Hsidetracked.  I really think that this should be coupled along
with a few other of the functions from src/sys/kern/subr_prf.c since they
all are very closely related (besides the log() functions).

Nevertheless, attached is the uprintf.9 man page.. I kind of just hacked
it up, so complete modification is welcome :-)

A copy can also be found at www.watson.org/~arr/fbsd-stuff/

Andrew

*-------------.................................................
| Andrew R. Reiter 
| arr@fledge.watson.org
| "It requires a very unusual mind
|   to undertake the analysis of the obvious" -- A.N. Whitehead

[-- Attachment #2 --]
.\"
.\" Copyright (c) 2001 Andrew R. Reiter.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 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.
.\"
.\"
.Dd April 25, 2001 
.Dt UPRINTF 9
.Os FreeBSD
.Sh NAME
.Nm uprintf
.Nd formatted output to the controlling terminal
.Sh SYNOPSIS
.Fd #include <sys/types.h>
.Fd #include <sys/systm.h>
.Ft int
.Fn uprintf "const char *fmt" "..."
.Sh DESCRIPTION
The
.Nm
function uses the calling process' controlling terminal in order 
to try and print the formatted output, similar to the libc 
.Fn printf
call.  The call will block for a short period of time if the tty queue
is full, but will return without printing the message if the queue is 
still full at the end of the allotted time.
.Pp
The call works under the control of the format string supplied as the 
first argument to the function in the same manner that the libc
.Fn printf
calls work.
.Pp
.El
.Sh RETURN VALUES
The
.Nm
function returns 0 on success as well as on failure. 

Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.NEB.3.96L.1010426004219.47696A-200000>