xref: /dflybsd-src/share/man/man9/device_printf.9 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
1*86d7f5d3SJohn Marino.\"
2*86d7f5d3SJohn Marino.\" Copyright (c) 2003 M. Warner Losh
3*86d7f5d3SJohn Marino.\" All rights reserved.
4*86d7f5d3SJohn Marino.\"
5*86d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
6*86d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
7*86d7f5d3SJohn Marino.\" are met:
8*86d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
9*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
10*86d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
11*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in the
12*86d7f5d3SJohn Marino.\"    documentation and/or other materials provided with the distribution.
13*86d7f5d3SJohn Marino.\"
14*86d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15*86d7f5d3SJohn Marino.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
16*86d7f5d3SJohn Marino.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17*86d7f5d3SJohn Marino.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
18*86d7f5d3SJohn Marino.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
19*86d7f5d3SJohn Marino.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
20*86d7f5d3SJohn Marino.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
21*86d7f5d3SJohn Marino.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
22*86d7f5d3SJohn Marino.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23*86d7f5d3SJohn Marino.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24*86d7f5d3SJohn Marino.\" SUCH DAMAGE.
25*86d7f5d3SJohn Marino.\"
26*86d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man9/device_printf.9,v 1.2 2003/05/30 21:13:32 ru Exp $
27*86d7f5d3SJohn Marino.\" $DragonFly: src/share/man/man9/device_printf.9,v 1.1 2007/10/06 20:41:55 swildner Exp $
28*86d7f5d3SJohn Marino.\"
29*86d7f5d3SJohn Marino.Dd October 6, 2007
30*86d7f5d3SJohn Marino.Dt DEVICE_PRINTF 9
31*86d7f5d3SJohn Marino.Os
32*86d7f5d3SJohn Marino.Sh NAME
33*86d7f5d3SJohn Marino.Nm device_printf
34*86d7f5d3SJohn Marino.Nd formatted output conversion
35*86d7f5d3SJohn Marino.Sh SYNOPSIS
36*86d7f5d3SJohn Marino.In sys/bus.h
37*86d7f5d3SJohn Marino.Ft int
38*86d7f5d3SJohn Marino.Fn device_printf "device_t dev" "const char *fmt" ...
39*86d7f5d3SJohn Marino.Sh DESCRIPTION
40*86d7f5d3SJohn MarinoThe
41*86d7f5d3SJohn Marino.Fn device_printf
42*86d7f5d3SJohn Marinofunction is a convenience interface to the
43*86d7f5d3SJohn Marino.Xr kprintf 9
44*86d7f5d3SJohn Marinofunction.
45*86d7f5d3SJohn MarinoIt outputs the name of the
46*86d7f5d3SJohn Marino.Fa dev
47*86d7f5d3SJohn Marinodevice, followed by a colon and a space, and then what
48*86d7f5d3SJohn Marino.Xr kprintf 9
49*86d7f5d3SJohn Marinowould print if you passed
50*86d7f5d3SJohn Marino.Fa fmt
51*86d7f5d3SJohn Marinoand the remaining arguments to it.
52*86d7f5d3SJohn Marino.Sh RETURN VALUES
53*86d7f5d3SJohn MarinoThe
54*86d7f5d3SJohn Marino.Fn device_printf
55*86d7f5d3SJohn Marinofunction returns the number of characters displayed.
56*86d7f5d3SJohn Marino.Sh SEE ALSO
57*86d7f5d3SJohn Marino.Xr printf 3 ,
58*86d7f5d3SJohn Marino.Xr kprintf 9
59