.\" Copyright (c) 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" %sccs.include.redist.man%
.\"
.\"     @(#)shar.1	5.6 (Berkeley) 03/23/93
.\"
.Dd 
.Dt SHAR 1
.Os BSD 4.4
.Sh NAME
.Nm shar
.Nd create a shell archive of files
.Sh SYNOPSIS
.Nm shar Ar
.Sh DESCRIPTION
.Nm Shar
writes an
.Xr sh 1
shell script to the standard output which will recreate the file
hierarchy specified by the command line operands.
Directories will be recreated and must be specified before the
files they contain (the
.Xr find 1
utility does this correctly).
.Pp
.Nm Shar
is normally used for distributing files by
.Xr ftp  1
or
.Xr mail  1  .
.Sh SEE ALSO
.Xr compress 1 ,
.Xr mail 1 ,
.Xr uuencode 1 ,
.Xr tar 1
.Sh BUGS
.Nm Shar
makes no provisions for special types of files or files containing
magic characters.
.Pp
It is easy to insert trojan horses into
.Nm shar
files.
It is strongly recommended that all shell archive files be examined
before running them through
.Xr sh  1  .
Archives produced using this implementation of
.Nm shar
may be easily examined with the command:
.Bd -literal -offset indent
egrep -v '^[X#]' shar.file
.Ed
.Sh EXAMPLES
To create a shell archive of the program
.Xr ls  1
and mail it to Rick:
.Bd -literal -offset indent
cd ls
shar `find . -print` \&|  mail -s "ls source" rick
.Ed
.Pp
To recreate the program directory:
.Bd -literal -offset indent
mkdir ls
cd ls
...
<delete header lines and examine mailed archive>
...
sh archive
.Ed
.Sh HISTORY
The
.Nm
command appears in
.Bx 4.4 .