diff options
Diffstat (limited to '')
| -rw-r--r-- | editasroot.8 | 85 |
1 files changed, 85 insertions, 0 deletions
diff --git a/editasroot.8 b/editasroot.8 new file mode 100644 index 0000000..d3940b5 --- /dev/null +++ b/editasroot.8 @@ -0,0 +1,85 @@ +.TH EDITASROOT 8 editasroot + +.SH NAME +editasroot - edit a file that requires root access + +.SH SYNOPSIS +.B editasroot +.I file + +.SH DESCRIPTION +The +.B editasroot +utility uses +.BR asroot(8) +to get access to the specified +.IR file , +creates a copy of the file and edits it with the +user's default editor, and then saves the new +content to the access restricted file. + +.SH OPTIONS +The +.B editasroot +utility conforms to the Base Definitions volume of POSIX.1-2017, +.IR "Section 12.2" , +.IR "Utility Syntax Guidelines" . +.PP +No option are supported. + +.SH OPERANDS +The following operand is supported: +.TP +.I file +The file to edit. + +.SH ENVIRONMENT VARIABLES +The following environment variables affects the execution of +.BR editasroot : +.TP +.SH EDITOR +Filename of the editor to edit the file path if the +program is started in the foreground or if +.B VISUAL +is unset. (Default is +.BR vi ) +.TP +.SH PATH +Default. See to the Base Definitions volume of POSIX.1-2017, Section 8.3, Other Environment Variables. +.TP +.SH VISUAL +Filename of the editor to edit the file path if the +program is started in the background. + +.SH EXIT STATUS +Default. + +.SH CONSEQUENCES OF ERRORS +Default. + +.SH APPLICATION USAGE +None. + +.SH EXAMPLES +None. + +.SH CAVEATS +The content of the file becomes accessible to the user and +can be read, and potentially edited (good timing is needed), +by malicious programs. If this is a security issue, do not +run this program! + +.SH RATIONALE +This utility lets users edit a file that requires root access, +but with his own editor configurations. + +.SH FUTURE DIRECTIONS +None. + +.SH SEE ALSO +.BR asroot (8), +.BR sudoedit (8) + +.SH AUTHORS +Mattias Andrée +.RI < maandree@kth.se > |