--- embedaddon/sudo/doc/visudo.man.in 2013/10/14 07:56:34 1.1.1.5 +++ embedaddon/sudo/doc/visudo.man.in 2014/06/15 16:12:54 1.1.1.6 @@ -1,7 +1,7 @@ .\" DO NOT EDIT THIS FILE, IT IS NOT THE MASTER! .\" IT IS GENERATED AUTOMATICALLY FROM visudo.mdoc.in .\" -.\" Copyright (c) 1996,1998-2005, 2007-2013 +.\" Copyright (c) 1996,1998-2005, 2007-2014 .\" Todd C. Miller .\" .\" Permission to use, copy, modify, and distribute this software for any @@ -21,7 +21,7 @@ .\" Agency (DARPA) and Air Force Research Laboratory, Air Force .\" Materiel Command, USAF, under agreement number F39502-99-1-0512. .\" -.TH "VISUDO" "@mansectsu@" "August 14, 2013" "Sudo @PACKAGE_VERSION@" "System Manager's Manual" +.TH "VISUDO" "@mansectsu@" "February 15, 2014" "Sudo @PACKAGE_VERSION@" "System Manager's Manual" .nh .if n .ad l .SH "NAME" @@ -32,6 +32,7 @@ \fBvisudo\fR [\fB\-chqsV\fR] [\fB\-f\fR\ \fIsudoers\fR] +[\fB\-x\fR\ \fIfile\fR] .SH "DESCRIPTION" \fBvisudo\fR edits the @@ -93,19 +94,19 @@ Upon finding an error, \fBvisudo\fR will print a message stating the line number(s) where the error occurred and the user will receive the -``What now?'' +\(lqWhat now?\(rq prompt. At this point the user may enter -`e' +\(oqe\(cq to re-edit the \fIsudoers\fR file, -`x' +\(oqx\(cq to exit without saving the changes, or -`Q' +\(oqQ\(cq to quit and save changes. The -`Q' +\(oqQ\(cq option should be used with extreme care because if \fBvisudo\fR believes there to be a parse error, so will @@ -115,7 +116,7 @@ will be able to \fBsudo\fR again until the error is fixed. If -`e' +\(oqe\(cq is typed to edit the \fIsudoers\fR file after a parse error has been detected, the cursor will be placed on @@ -157,14 +158,14 @@ instead of the default, The lock file used is the specified \fIsudoers\fR file with -``\.tmp'' +\(lq\.tmp\(rq appended to it. In \fIcheck-only\fR mode only, the argument to \fB\-f\fR may be -`-', +\(oq-\(cq, indicating that \fIsudoers\fR will be read from the standard input. @@ -194,7 +195,7 @@ will consider this a parse error. Note that it is not possible to differentiate between an alias and a host name or user name that consists solely of uppercase letters, digits, and the underscore -(`_') +(\(oq_\(cq) character. .TP 12n \fB\-V\fR, \fB\--version\fR @@ -203,6 +204,27 @@ Print the and \fIsudoers\fR grammar versions and exit. +.TP 12n +\fB\-x\fR \fIfile\fR, \fB\--export\fR=\fIfile\fR +Export +\fIsudoers\fR +in JSON format and write it to +\fIfile\fR. +If +\fIfile\fR +is +\(oq-\(cq, +the exported +\fIsudoers\fR +policy will be written to the standard output. +The exported format is intended to be easier for third-party +applications to parse than the traditional +\fIsudoers\fR +format. +The various values have explicit types which removes much of the +ambiguity of the +\fIsudoers\fR +format. .SH "ENVIRONMENT" The following environment variables may be consulted depending on the value of the @@ -249,7 +271,7 @@ Your user ID does not appear in the system passwd file Either you are trying to use an undeclared {User,Runas,Host,Cmnd}_Alias or you have a user or host name listed that consists solely of uppercase letters, digits, and the underscore -(`_') +(\(oq_\(cq) character. In the latter case, you can ignore the warnings (\fBsudo\fR @@ -311,7 +333,7 @@ search the archives. .SH "DISCLAIMER" \fBvisudo\fR is provided -``AS IS'' +\(lqAS IS\(rq and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed.