smrsh man page on PC-BSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
PC-BSD logo
[printable version]

SMRSH(8)							      SMRSH(8)

NAME
       smrsh - restricted shell for sendmail

SYNOPSIS
       smrsh -c command

DESCRIPTION
       The  smrsh  program  is intended as a replacement for sh for use in the
       ``prog'' mailer in sendmail(8) configuration files.  It sharply	limits
       the  commands that can be run using the ``|program'' syntax of sendmail
       in order to improve the over all security  of  your  system.   Briefly,
       even  if	 a ``bad guy'' can get sendmail to run a program without going
       through an alias or forward file, smrsh limits the set of programs that
       he or she can execute.

       Briefly,	 smrsh limits programs to be in a single directory, by default
       /usr/libexec/sm.bin, allowing the system administrator  to  choose  the
       set of acceptable commands, and to the shell builtin commands ``exec'',
       ``exit'', and ``echo''.	It also rejects any commands with the  charac‐
       ters ``', `<', `>', `;', `$', `(', `)', `\r' (carriage return), or `\n'
       (newline) on the command line  to  prevent  ``end  run''	 attacks.   It
       allows	``||''	 and   ``&&''	to   enable  commands  like:  ``"|exec
       /usr/local/bin/filter || exit 75"''

       Initial	pathnames  on  programs	 are  stripped,	  so   forwarding   to
       ``/usr/bin/vacation'', ``/home/server/mydir/bin/vacation'', and ``vaca‐
       tion'' all actually forward to ``/usr/libexec/sm.bin/vacation''.

       System administrators  should  be  conservative	about  populating  the
       sm.bin  directory.  For example, a reasonable additions is vacation(1),
       and the like.  No matter how brow-beaten you may be, never include  any
       shell  or shell-like program (such as perl(1)) in the sm.bin directory.
       Note that this does not restrict the use of shell or  perl  scripts  in
       the  sm.bin  directory  (using  the ``#!'' syntax); it simply disallows
       execution of arbitrary programs.	 Also, including mail  filtering  pro‐
       grams such as procmail(1) is a very bad idea.  procmail(1) allows users
       to run arbitrary programs in their procmailrc(5).

COMPILATION
       Compilation should be trivial on most systems.  You  may	 need  to  use
       -DSMRSH_PATH=\"path\"  to  adjust  the default search path (defaults to
       ``/bin:/usr/bin'') and/or -DSMRSH_CMDDIR=\"dir\" to change the  default
       program directory (defaults to ``/usr/libexec/sm.bin'').

FILES
       /usr/adm/sm.bin - default directory for restricted programs on most OSs

       /var/adm/sm.bin	-  directory  for  restricted  programs	 on  HP UX and
       Solaris

       /usr/libexec/sm.bin - directory for restricted programs on FreeBSD  (>=
       3.3) and DragonFly BSD

SEE ALSO
       sendmail(8)

			 $Date: 2004/08/06 03:55:35 $		      SMRSH(8)
[top]

List of man pages available for PC-BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net