Date: Wed, 23 Sep 2020 21:12:04 +0300 From: xtouqh@hotmail.com To: Warner Losh <imp@FreeBSD.org>, src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: Re: svn commit: r366025 - head/share/man/man9 Message-ID: <AM0PR06MB39862619C95CEA07990D7848C0380@AM0PR06MB3986.eurprd06.prod.outlook.com> In-Reply-To: <202009222301.08MN1rkh076778@repo.freebsd.org> References: <202009222301.08MN1rkh076778@repo.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Warner Losh wrote: > Author: imp > Date: Tue Sep 22 23:01:53 2020 > New Revision: 366025 > URL: https://svnweb.freebsd.org/changeset/base/366025 > > Log: > Document devctl_safe_quote_sb > > This routine centralizes the knowledge needed for properly quoting > 'value' in all key="value" items that appear in devctl messages. > > Reviewed by: bcr > Differential Revision: https://reviews.freebsd.org/D26520 > > Added: > head/share/man/man9/devctl_safe_quote_sb.9 (contents, props changed) > Modified: > head/share/man/man9/Makefile > > Modified: head/share/man/man9/Makefile > ============================================================================== > --- head/share/man/man9/Makefile Tue Sep 22 23:01:44 2020 (r366024) > +++ head/share/man/man9/Makefile Tue Sep 22 23:01:53 2020 (r366025) > @@ -122,6 +122,8 @@ MAN= accept_filter.9 \ > DEV_MODULE.9 \ > dev_refthread.9 \ > devctl_process_running.9 \ > + devctl_safe_quote_sb.9 \ > + devctl_ > devstat.9 \ > devtoname.9 \ > disk.9 \ > > Added: head/share/man/man9/devctl_safe_quote_sb.9 > ============================================================================== > --- /dev/null 00:00:00 1970 (empty, because file is newly added) > +++ head/share/man/man9/devctl_safe_quote_sb.9 Tue Sep 22 23:01:53 2020 (r366025) > @@ -0,0 +1,57 @@ > +.\" > +.\" Copyright (c) 2020 M Warner Losh > +.\" > +.\" This program is free software. > +.\" > +.\" 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 DEVELOPERS ``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 DEVELOPERS 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. > +.\" > +.\" $FreeBSD$ > +.\" > +.Dd September 22, 2020 > +.Dt DEVCTL_SAFE_QUOTE_SB 9 > +.Os > +.Sh NAME > +.Nm devctl_safe_quote_sb > +.Nd Insert a string, properly quoted, into a sbuf > +.Sh SYNOPSIS > +.In sys/devctl.h > +.In sys/sbuf.h > +.Ft void > +.Fn devctl_safe_quote_sb "struct sbuf *sb" "const char *src" > +.Sh DESCRIPTION > +Copy the string from > +.Vn src .Va > +into > +.Vn sb . .Va > +All backslash characters are doubled. > +All double quote characters > +.Sq " .Sq \&" > +are also preceded by a backslash. > +All other characters are copied without modification. > +The > +.Xr devctl 4 > +protocol requires quoted string to be quoted thus. > +This routine centralizes this knowledge. > +.Sh SEE ALSO > +.Xr devd 8 > +.Sh AUTHORS > +This manual page was written by > +.An M. Warner Losh
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?AM0PR06MB39862619C95CEA07990D7848C0380>