pinky

simple and hopefully secure finger(1) replacement
git clone https://git.e1e0.net/pinky.git
Log | Files | Refs

pinky.1 (1700B)


      1 .\" Copyright (c) 2020 Paco Esteban <paco@e1e0.net>
      2 .\"
      3 .\" Permission to use, copy, modify, and distribute this software for any
      4 .\" purpose with or without fee is hereby granted, provided that the above
      5 .\" copyright notice and this permission notice appear in all copies.
      6 .\"
      7 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
      8 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
      9 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
     10 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
     11 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
     12 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
     13 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
     14 .\"
     15 .Dd December 13, 2020
     16 .Dt PINKY 1
     17 .Os
     18 .Sh NAME
     19 .Nm pinky
     20 .Nd small and hopefully secure
     21 .Xr finger 1
     22 replacement
     23 .Sh SYNOPSIS
     24 .Nm
     25 .Op Fl d Ar directory
     26 .Ar user
     27 .Sh DESCRIPTION
     28 .Nm
     29 is supposed to be invoked by
     30 .Xr fingerd 8 .
     31 It looks for a file named as the user in the folder specified by
     32 .Fl d .
     33 If
     34 .Fl d
     35 is not provided, the default folder is
     36 .Pa /var/pinky .
     37 .Pp
     38 .Nm
     39 uses
     40 .Xr unveil 2
     41 to limit itself to the default folder or the one provided by
     42 .Fl d ,
     43 and uses
     44 .Xr pledge 2
     45 to limit itself to
     46 .Va stdio
     47 and
     48 .Va rpath .
     49 .Pp
     50 The options are as follows:
     51 .Bl -tag -width Ds
     52 .It Fl d Ar directory
     53 The folder where all the user info resides.
     54 .It Ar user
     55 The user name to get the info from.
     56 .El
     57 .Sh EXIT STATUS
     58 .Ex -std
     59 .Sh AUTHORS
     60 .An Paco Esteban
     61 .Mt paco@e1e0.net
     62 .Sh BUGS
     63 I hope not so many, as this is running in one of my servers :-)
     64 .Pp
     65 If you find horrors, send patches to:
     66 .Mt patches@e1e0.net