xref: /freebsd/contrib/openpam/bin/su/su.1 (revision 3ba4c8c81a28de3e00ccf6d7f92c6f8e58bef456)
17f106882SDag-Erling Smørgrav.\"-
249e56509SDag-Erling Smørgrav.\" Copyright (c) 2011-2017 Dag-Erling Smørgrav
37f106882SDag-Erling Smørgrav.\" All rights reserved.
47f106882SDag-Erling Smørgrav.\"
57f106882SDag-Erling Smørgrav.\" Redistribution and use in source and binary forms, with or without
67f106882SDag-Erling Smørgrav.\" modification, are permitted provided that the following conditions
77f106882SDag-Erling Smørgrav.\" are met:
87f106882SDag-Erling Smørgrav.\" 1. Redistributions of source code must retain the above copyright
97f106882SDag-Erling Smørgrav.\"    notice, this list of conditions and the following disclaimer.
107f106882SDag-Erling Smørgrav.\" 2. Redistributions in binary form must reproduce the above copyright
117f106882SDag-Erling Smørgrav.\"    notice, this list of conditions and the following disclaimer in the
127f106882SDag-Erling Smørgrav.\"    documentation and/or other materials provided with the distribution.
132f3ed619SDag-Erling Smørgrav.\" 3. The name of the author may not be used to endorse or promote
142f3ed619SDag-Erling Smørgrav.\"    products derived from this software without specific prior written
152f3ed619SDag-Erling Smørgrav.\"    permission.
167f106882SDag-Erling Smørgrav.\"
177f106882SDag-Erling Smørgrav.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
187f106882SDag-Erling Smørgrav.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
197f106882SDag-Erling Smørgrav.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
207f106882SDag-Erling Smørgrav.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
217f106882SDag-Erling Smørgrav.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
227f106882SDag-Erling Smørgrav.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
237f106882SDag-Erling Smørgrav.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
247f106882SDag-Erling Smørgrav.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
257f106882SDag-Erling Smørgrav.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
267f106882SDag-Erling Smørgrav.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
277f106882SDag-Erling Smørgrav.\" SUCH DAMAGE.
287f106882SDag-Erling Smørgrav.\"
29*3ba4c8c8SDag-Erling Smørgrav.Dd June 27, 2023
307f106882SDag-Erling Smørgrav.Dt SU 1
317f106882SDag-Erling Smørgrav.Os
327f106882SDag-Erling Smørgrav.Sh NAME
337f106882SDag-Erling Smørgrav.Nm su
347f106882SDag-Erling Smørgrav.Nd switch user identity
35d64f4044SDag-Erling Smørgrav.Sh SYNOPSIS
367f106882SDag-Erling Smørgrav.Nm
377f106882SDag-Erling Smørgrav.Op Ar login Op Ar ...
387f106882SDag-Erling Smørgrav.Sh DESCRIPTION
397f106882SDag-Erling SmørgravThe
407f106882SDag-Erling Smørgrav.Nm
417f106882SDag-Erling Smørgravutility starts a shell under the identity of the user specified by the
427f106882SDag-Erling Smørgravfirst argument on the command line.
437f106882SDag-Erling SmørgravIf no user is specified, the default is
447f106882SDag-Erling Smørgrav.Dq root .
457f106882SDag-Erling Smørgrav.Pp
467f106882SDag-Erling SmørgravAny additional command-line arguments are passed as-is to the shell.
477f106882SDag-Erling Smørgrav.Pp
487f106882SDag-Erling SmørgravThe requesting user is authenticated using the
497f106882SDag-Erling Smørgrav.Dq su
507f106882SDag-Erling SmørgravPAM policy.
517f106882SDag-Erling Smørgrav.Sh IMPLEMENTATION NOTES
527f106882SDag-Erling SmørgravThe
537f106882SDag-Erling Smørgrav.Nm
547f106882SDag-Erling Smørgravutility is provided with the OpenPAM library as a sample application
557f106882SDag-Erling Smørgravand should not be used in production systems.
567f106882SDag-Erling Smørgrav.Sh SEE ALSO
572f3ed619SDag-Erling Smørgrav.Xr openpam 3 ,
587f106882SDag-Erling Smørgrav.Xr pam 3
597f106882SDag-Erling Smørgrav.Sh AUTHORS
607f106882SDag-Erling SmørgravThe
617f106882SDag-Erling Smørgrav.Nm
627f106882SDag-Erling Smørgravutility and this manual page were written by
63f3b0ac34SDag-Erling Smørgrav.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
64