1cefd51ecSDoug Rabson.\" -*- nroff -*- 2cefd51ecSDoug Rabson.\" 3cefd51ecSDoug Rabson.\" Copyright (c) 1998 Doug Rabson 4cefd51ecSDoug Rabson.\" 5cefd51ecSDoug Rabson.\" All rights reserved. 6cefd51ecSDoug Rabson.\" 7cefd51ecSDoug Rabson.\" This program is free software. 8cefd51ecSDoug Rabson.\" 9cefd51ecSDoug Rabson.\" Redistribution and use in source and binary forms, with or without 10cefd51ecSDoug Rabson.\" modification, are permitted provided that the following conditions 11cefd51ecSDoug Rabson.\" are met: 12cefd51ecSDoug Rabson.\" 1. Redistributions of source code must retain the above copyright 13cefd51ecSDoug Rabson.\" notice, this list of conditions and the following disclaimer. 14cefd51ecSDoug Rabson.\" 2. Redistributions in binary form must reproduce the above copyright 15cefd51ecSDoug Rabson.\" notice, this list of conditions and the following disclaimer in the 16cefd51ecSDoug Rabson.\" documentation and/or other materials provided with the distribution. 17cefd51ecSDoug Rabson.\" 18cefd51ecSDoug Rabson.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR 19cefd51ecSDoug Rabson.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 20cefd51ecSDoug Rabson.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 21cefd51ecSDoug Rabson.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, 22cefd51ecSDoug Rabson.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 23cefd51ecSDoug Rabson.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 24cefd51ecSDoug Rabson.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 25cefd51ecSDoug Rabson.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 26cefd51ecSDoug Rabson.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 27cefd51ecSDoug Rabson.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 28cefd51ecSDoug Rabson.\" 29*6b6914c1SChristos Margiolis.Dd January 9, 2024 30def37e7cSMike Pritchard.Dt DEVICE_SET_DESC 9 313d45e180SRuslan Ermilov.Os 32cefd51ecSDoug Rabson.Sh NAME 33cefd51ecSDoug Rabson.Nm device_set_desc , 34*6b6914c1SChristos Margiolis.Nm device_set_descf , 35b99b8460SDoug Rabson.Nm device_set_desc_copy , 36cefd51ecSDoug Rabson.Nm device_get_desc 37cefd51ecSDoug Rabson.Nd access the description of a device 38cefd51ecSDoug Rabson.Sh SYNOPSIS 3932eef9aeSRuslan Ermilov.In sys/param.h 4032eef9aeSRuslan Ermilov.In sys/bus.h 41cefd51ecSDoug Rabson.Ft void 42cefd51ecSDoug Rabson.Fn device_set_desc "device_t dev" "const char *desc" 43b99b8460SDoug Rabson.Ft void 44*6b6914c1SChristos Margiolis.Fn device_set_descf "device_t dev" "const char *fmt" "..." 45*6b6914c1SChristos Margiolis.Ft void 46b99b8460SDoug Rabson.Fn device_set_desc_copy "device_t dev" "const char *desc" 47cefd51ecSDoug Rabson.Ft const char * 48cefd51ecSDoug Rabson.Fn device_get_desc "device_t dev" 49cefd51ecSDoug Rabson.Sh DESCRIPTION 50a0942a60SHiten PandyaManipulate the verbose description of a device. 51a0942a60SHiten PandyaThis description (if 52cefd51ecSDoug Rabsonpresent) is printed as part of the message when it is attached during 531111b49cSSheldon Hearnautoconfiguration. 541111b49cSSheldon HearnThe variation 55facc6767SRuslan Ermilov.Fn device_set_desc_copy 56b99b8460SDoug Rabsonis used to set the description if the string passed is a temporary 571111b49cSSheldon Hearnbuffer which will be overwritten. 581111b49cSSheldon HearnIn this case, the system will copy 59b99b8460SDoug Rabsonthe string, otherwise the pointer passed will be used directly. 60*6b6914c1SChristos Margiolis.Fn device_set_descf 61*6b6914c1SChristos Margiolisis a printf-like version of 62*6b6914c1SChristos Margiolis.Fn device_set_desc . 63cefd51ecSDoug Rabson.Sh SEE ALSO 64cefd51ecSDoug Rabson.Xr device 9 65cefd51ecSDoug Rabson.Sh AUTHORS 6609356c84SHiten PandyaThis manual page was written by 67cefd51ecSDoug Rabson.An Doug Rabson . 68