xref: /dflybsd-src/share/man/man9/device_printf.9 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
186d7f5d3SJohn Marino.\"
286d7f5d3SJohn Marino.\" Copyright (c) 2003 M. Warner Losh
386d7f5d3SJohn Marino.\" All rights reserved.
486d7f5d3SJohn Marino.\"
586d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
686d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
786d7f5d3SJohn Marino.\" are met:
886d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
986d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
1086d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
1186d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in the
1286d7f5d3SJohn Marino.\"    documentation and/or other materials provided with the distribution.
1386d7f5d3SJohn Marino.\"
1486d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
1586d7f5d3SJohn Marino.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
1686d7f5d3SJohn Marino.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
1786d7f5d3SJohn Marino.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
1886d7f5d3SJohn Marino.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
1986d7f5d3SJohn Marino.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
2086d7f5d3SJohn Marino.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
2186d7f5d3SJohn Marino.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
2286d7f5d3SJohn Marino.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2386d7f5d3SJohn Marino.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2486d7f5d3SJohn Marino.\" SUCH DAMAGE.
2586d7f5d3SJohn Marino.\"
2686d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man9/device_printf.9,v 1.2 2003/05/30 21:13:32 ru Exp $
2786d7f5d3SJohn Marino.\" $DragonFly: src/share/man/man9/device_printf.9,v 1.1 2007/10/06 20:41:55 swildner Exp $
2886d7f5d3SJohn Marino.\"
2986d7f5d3SJohn Marino.Dd October 6, 2007
3086d7f5d3SJohn Marino.Dt DEVICE_PRINTF 9
3186d7f5d3SJohn Marino.Os
3286d7f5d3SJohn Marino.Sh NAME
3386d7f5d3SJohn Marino.Nm device_printf
3486d7f5d3SJohn Marino.Nd formatted output conversion
3586d7f5d3SJohn Marino.Sh SYNOPSIS
3686d7f5d3SJohn Marino.In sys/bus.h
3786d7f5d3SJohn Marino.Ft int
3886d7f5d3SJohn Marino.Fn device_printf "device_t dev" "const char *fmt" ...
3986d7f5d3SJohn Marino.Sh DESCRIPTION
4086d7f5d3SJohn MarinoThe
4186d7f5d3SJohn Marino.Fn device_printf
4286d7f5d3SJohn Marinofunction is a convenience interface to the
4386d7f5d3SJohn Marino.Xr kprintf 9
4486d7f5d3SJohn Marinofunction.
4586d7f5d3SJohn MarinoIt outputs the name of the
4686d7f5d3SJohn Marino.Fa dev
4786d7f5d3SJohn Marinodevice, followed by a colon and a space, and then what
4886d7f5d3SJohn Marino.Xr kprintf 9
4986d7f5d3SJohn Marinowould print if you passed
5086d7f5d3SJohn Marino.Fa fmt
5186d7f5d3SJohn Marinoand the remaining arguments to it.
5286d7f5d3SJohn Marino.Sh RETURN VALUES
5386d7f5d3SJohn MarinoThe
5486d7f5d3SJohn Marino.Fn device_printf
5586d7f5d3SJohn Marinofunction returns the number of characters displayed.
5686d7f5d3SJohn Marino.Sh SEE ALSO
5786d7f5d3SJohn Marino.Xr printf 3 ,
5886d7f5d3SJohn Marino.Xr kprintf 9
59