1 09a12e37 2016-09-08 martijn .\"
  2 7df505fb 2025-01-27 martijn .\"Copyright (c) 2016 Martijn van Duren <martijn@openbsd.org>
  3 09a12e37 2016-09-08 martijn .\"Copyright (c) 2015 Ted Unangst <tedu@openbsd.org>
  4 09a12e37 2016-09-08 martijn .\"
  5 09a12e37 2016-09-08 martijn .\"Permission to use, copy, modify, and distribute this software for any
  6 09a12e37 2016-09-08 martijn .\"purpose with or without fee is hereby granted, provided that the above
  7 09a12e37 2016-09-08 martijn .\"copyright notice and this permission notice appear in all copies.
  8 09a12e37 2016-09-08 martijn .\"
  9 09a12e37 2016-09-08 martijn .\"THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 10 09a12e37 2016-09-08 martijn .\"WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 11 09a12e37 2016-09-08 martijn .\"MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 12 09a12e37 2016-09-08 martijn .\"ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 13 09a12e37 2016-09-08 martijn .\"WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 14 09a12e37 2016-09-08 martijn .\"ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 15 09a12e37 2016-09-08 martijn .\"OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 16 09a12e37 2016-09-08 martijn .Dd $Mdocdate: September 2 2016 $
 17 09a12e37 2016-09-08 martijn .Dt VIAS 1
 18 09a12e37 2016-09-08 martijn .Os
 19 09a12e37 2016-09-08 martijn .Sh NAME
 20 09a12e37 2016-09-08 martijn .Nm vias
 21 09a12e37 2016-09-08 martijn .Nd edit a file owned by another user
 22 09a12e37 2016-09-08 martijn .Sh SYNOPSIS
 23 09a12e37 2016-09-08 martijn .Nm vias
 24 09a12e37 2016-09-08 martijn .Op Fl a Ar style
 25 09a12e37 2016-09-08 martijn .Op Fl C Ar config
 26 09a12e37 2016-09-08 martijn .Ar file
 27 09a12e37 2016-09-08 martijn .Op Ar editor flags
 28 09a12e37 2016-09-08 martijn .Sh DESCRIPTION
 29 09a12e37 2016-09-08 martijn The
 30 09a12e37 2016-09-08 martijn .Nm
 31 09a12e37 2016-09-08 martijn utility makes a temporary copy of
 32 09a12e37 2016-09-08 martijn .Ar file
 33 09a12e37 2016-09-08 martijn normaly not accessible by the user and allows the user to edit the temporary
 34 09a12e37 2016-09-08 martijn .Ar file
 35 09a12e37 2016-09-08 martijn with their own editor.
 36 09a12e37 2016-09-08 martijn Upon exit the temporary file is copied back to the original file.
 37 09a12e37 2016-09-08 martijn .Pp
 38 09a12e37 2016-09-08 martijn The options are as follows:
 39 09a12e37 2016-09-08 martijn .Bl -tag -width tenletters
 40 09a12e37 2016-09-08 martijn .It Fl a Ar style
 41 09a12e37 2016-09-08 martijn Use the specified authentication style when validating the user,
 42 09a12e37 2016-09-08 martijn as allowed by
 43 09a12e37 2016-09-08 martijn .Pa /etc/login.conf .
 44 09a12e37 2016-09-08 martijn A list of doas-specific authentication methods may be configured by adding an
 45 09a12e37 2016-09-08 martijn .Sq auth-doas
 46 09a12e37 2016-09-08 martijn entry in
 47 09a12e37 2016-09-08 martijn .Xr login.conf 5 .
 48 09a12e37 2016-09-08 martijn .It Fl C Ar config
 49 09a12e37 2016-09-08 martijn Parse and check the configuration file
 50 09a12e37 2016-09-08 martijn .Ar config ,
 51 09a12e37 2016-09-08 martijn then exit.
 52 09a12e37 2016-09-08 martijn If
 53 09a12e37 2016-09-08 martijn .Ar file 
 54 09a12e37 2016-09-08 martijn is supplied,
 55 09a12e37 2016-09-08 martijn .Nm
 56 09a12e37 2016-09-08 martijn will also try to open the
 57 09a12e37 2016-09-08 martijn .Ar file .
 58 09a12e37 2016-09-08 martijn In the latter case
 59 09a12e37 2016-09-08 martijn either
 60 09a12e37 2016-09-08 martijn .Sq permit ,
 61 09a12e37 2016-09-08 martijn .Sq permit nopass
 62 09a12e37 2016-09-08 martijn or
 63 09a12e37 2016-09-08 martijn .Sq deny
 64 09a12e37 2016-09-08 martijn will be printed on standard output, depending on file
 65 09a12e37 2016-09-08 martijn matching results.
 66 09a12e37 2016-09-08 martijn No copy will be made.
 67 09a12e37 2016-09-08 martijn .El
 68 09a12e37 2016-09-08 martijn .Sh EXIT STATUS
 69 d69feec1 2025-01-27 martijn .Ex -std vias
 70 09a12e37 2016-09-08 martijn It may fail for one of the following reasons:
 71 09a12e37 2016-09-08 martijn .Pp
 72 09a12e37 2016-09-08 martijn .Bl -bullet -compact
 73 09a12e37 2016-09-08 martijn .It
 74 09a12e37 2016-09-08 martijn The config file
 75 09a12e37 2016-09-08 martijn .Pa /etc/vias.conf
 76 09a12e37 2016-09-08 martijn could not be parsed.
 77 09a12e37 2016-09-08 martijn .It
 78 09a12e37 2016-09-08 martijn The user attempted to open a file which is not permitted.
 79 09a12e37 2016-09-08 martijn .It
 80 09a12e37 2016-09-08 martijn The password was incorrect.
 81 09a12e37 2016-09-08 martijn .It
 82 09a12e37 2016-09-08 martijn The 
 83 09a12e37 2016-09-08 martijn .Xr open 2
 84 09a12e37 2016-09-08 martijn command failed.
 85 09a12e37 2016-09-08 martijn .El
 86 09a12e37 2016-09-08 martijn .Sh ENVIRONMENT
 87 09a12e37 2016-09-08 martijn If the following environment variable exists it will be utilized by
 88 09a12e37 2016-09-08 martijn .Nm :
 89 09a12e37 2016-09-08 martijn .Bl -tag -width EDITOR
 90 09a12e37 2016-09-08 martijn .It Ev EDITOR
 91 09a12e37 2016-09-08 martijn The editor specified by the string
 92 09a12e37 2016-09-08 martijn .Ev EDITOR
 93 09a12e37 2016-09-08 martijn will be invoked instead of the default editor
 94 09a12e37 2016-09-08 martijn .Xr vi 1 .
 95 09a12e37 2016-09-08 martijn .El
 96 09a12e37 2016-09-08 martijn 
 97 09a12e37 2016-09-08 martijn .Sh SEE ALSO
 98 09a12e37 2016-09-08 martijn .Xr doas 1 ,
 99 09a12e37 2016-09-08 martijn .Xr vias.conf 5
100 09a12e37 2016-09-08 martijn .Sh AUTHORS
101 7df505fb 2025-01-27 martijn .An Martijn van Duren Aq Mt martijn@openbsd.org