1.\" Copyright (c) 2017  Peter Pentchev
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.Dd January 24, 2017
26.Dt RNAME 1
27.Os
28.Sh NAME
29.Nm rname
30.Nd invoke a program under a different name
31.Sh SYNOPSIS
32.Nm
33.Ar fakename
34.Ar realname
35.Op Ar args...
36.Nm
37.Op Fl V | Fl h
38.Sh DESCRIPTION
39The
40.Nm
41utility invokes the specified program, passing a different name instead of
42the name of the program executable.
43.Pp
44The
45.Nm
46utility accepts the following command-line options:
47.Bl -tag -width indent
48.It Fl h
49Display program usage information and exit.
50.It Fl V
51Display program version information and exit.
52.El
53.Sh ENVIRONMENT
54The operation of the
55.Nm
56utility is not directly influenced by any environment variables.
57.Sh FILES
58The operation of the
59.Nm
60utility is not directly influenced by the contents of any files.
61.Sh EXAMPLES
62Run bunzip2 as bzcat:
63.Pp
64.Dl rname bzcat bunzip2 foo.txt.bz2
65.Pp
66.Sh DIAGNOSTICS
67.Ex -std
68.Sh SEE ALSO
69.Xr execvp 3
70.Sh STANDARDS
71No standards were harmed during the production of the
72.Nm
73utility.
74.Sh HISTORY
75The
76.Nm
77utility was written by Peter Pentchev in 2010 and then
78resurrected in 2017.
79.Sh AUTHORS
80.An Peter Pentchev
81.Aq roam@ringlet.net
82.Sh BUGS
83No, thank you :)
84But if you should actually find any, please report them
85to the author.
86