--- embedaddon/sudo/doc/visudo.mdoc.in 2013/10/14 07:56:34 1.1.1.3 +++ embedaddon/sudo/doc/visudo.mdoc.in 2014/06/15 16:12:54 1.1.1.4 @@ -1,5 +1,5 @@ .\" -.\" 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 @@ -19,7 +19,7 @@ .\" Agency (DARPA) and Air Force Research Laboratory, Air Force .\" Materiel Command, USAF, under agreement number F39502-99-1-0512. .\" -.Dd August 14, 2013 +.Dd February 15, 2014 .Dt VISUDO @mansectsu@ .Os Sudo @PACKAGE_VERSION@ .Sh NAME @@ -28,9 +28,8 @@ .Sh SYNOPSIS .Nm visudo .Op Fl chqsV -.Bk -words .Op Fl f Ar sudoers -.Ek +.Op Fl x Ar file .Sh DESCRIPTION .Nm visudo edits the @@ -141,7 +140,7 @@ will exit with a value of 0. If an error is encountered, .Nm visudo will exit with a value of 1. -.It Fl f Ar sudoers , Fl -file Ns No = Ns Ar sudoers +.It Fl f Ar sudoers , Fl -file Ns = Ns Ar sudoers Specify an alternate .Em sudoers file location. @@ -197,6 +196,26 @@ Print the and .Em sudoers grammar versions and exit. +.It Fl x Ar file , Fl -export Ns = Ns Ar file +Export +.Em sudoers +in JSON format and write it to +.Ar file . +If +.Ar file +is +.Ql - , +the exported +.Em sudoers +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 +.Em sudoers +format. +The various values have explicit types which removes much of the +ambiguity of the +.Em sudoers +format. .El .Sh ENVIRONMENT The following environment variables may be consulted depending on