19b50d902SRodney W. Grimes.\" Copyright (c) 1990, 1993 29b50d902SRodney W. Grimes.\" The Regents of the University of California. All rights reserved. 39b50d902SRodney W. Grimes.\" 49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without 59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions 69b50d902SRodney W. Grimes.\" are met: 79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright 89b50d902SRodney W. Grimes.\" notice, this list of conditions and the following disclaimer. 99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright 109b50d902SRodney W. Grimes.\" notice, this list of conditions and the following disclaimer in the 119b50d902SRodney W. Grimes.\" documentation and/or other materials provided with the distribution. 129b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software 139b50d902SRodney W. Grimes.\" must display the following acknowledgement: 149b50d902SRodney W. Grimes.\" This product includes software developed by the University of 159b50d902SRodney W. Grimes.\" California, Berkeley and its contributors. 169b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors 179b50d902SRodney W. Grimes.\" may be used to endorse or promote products derived from this software 189b50d902SRodney W. Grimes.\" without specific prior written permission. 199b50d902SRodney W. Grimes.\" 209b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 219b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 229b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 239b50d902SRodney W. Grimes.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 249b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 259b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 269b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 279b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 289b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 299b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 309b50d902SRodney W. Grimes.\" SUCH DAMAGE. 319b50d902SRodney W. Grimes.\" 329b50d902SRodney W. Grimes.\" @(#)shar.1 8.1 (Berkeley) 6/6/93 339b50d902SRodney W. Grimes.\" 349b50d902SRodney W. Grimes.Dd June 6, 1993 359b50d902SRodney W. Grimes.Dt SHAR 1 369b50d902SRodney W. Grimes.Os BSD 4.4 379b50d902SRodney W. Grimes.Sh NAME 389b50d902SRodney W. Grimes.Nm shar 399b50d902SRodney W. Grimes.Nd create a shell archive of files 409b50d902SRodney W. Grimes.Sh SYNOPSIS 419b50d902SRodney W. Grimes.Nm shar Ar 429b50d902SRodney W. Grimes.Sh DESCRIPTION 439b50d902SRodney W. Grimes.Nm Shar 449b50d902SRodney W. Grimeswrites an 459b50d902SRodney W. Grimes.Xr sh 1 469b50d902SRodney W. Grimesshell script to the standard output which will recreate the file 479b50d902SRodney W. Grimeshierarchy specified by the command line operands. 489b50d902SRodney W. GrimesDirectories will be recreated and must be specified before the 499b50d902SRodney W. Grimesfiles they contain (the 509b50d902SRodney W. Grimes.Xr find 1 519b50d902SRodney W. Grimesutility does this correctly). 529b50d902SRodney W. Grimes.Pp 539b50d902SRodney W. Grimes.Nm Shar 549b50d902SRodney W. Grimesis normally used for distributing files by 559b50d902SRodney W. Grimes.Xr ftp 1 569b50d902SRodney W. Grimesor 579b50d902SRodney W. Grimes.Xr mail 1 . 589b50d902SRodney W. Grimes.Sh SEE ALSO 599b50d902SRodney W. Grimes.Xr compress 1 , 609b50d902SRodney W. Grimes.Xr mail 1 , 619b50d902SRodney W. Grimes.Xr uuencode 1 , 629b50d902SRodney W. Grimes.Xr tar 1 639b50d902SRodney W. Grimes.Sh BUGS 649b50d902SRodney W. Grimes.Nm Shar 659b50d902SRodney W. Grimesmakes no provisions for special types of files or files containing 669b50d902SRodney W. Grimesmagic characters. 679b50d902SRodney W. Grimes.Pp 689b50d902SRodney W. GrimesIt is easy to insert trojan horses into 699b50d902SRodney W. Grimes.Nm shar 709b50d902SRodney W. Grimesfiles. 719b50d902SRodney W. GrimesIt is strongly recommended that all shell archive files be examined 729b50d902SRodney W. Grimesbefore running them through 739b50d902SRodney W. Grimes.Xr sh 1 . 749b50d902SRodney W. GrimesArchives produced using this implementation of 759b50d902SRodney W. Grimes.Nm shar 769b50d902SRodney W. Grimesmay be easily examined with the command: 779b50d902SRodney W. Grimes.Bd -literal -offset indent 789b50d902SRodney W. Grimesegrep -v '^[X#]' shar.file 799b50d902SRodney W. Grimes.Ed 809b50d902SRodney W. Grimes.Sh EXAMPLES 819b50d902SRodney W. GrimesTo create a shell archive of the program 829b50d902SRodney W. Grimes.Xr ls 1 839b50d902SRodney W. Grimesand mail it to Rick: 849b50d902SRodney W. Grimes.Bd -literal -offset indent 859b50d902SRodney W. Grimescd ls 869b50d902SRodney W. Grimesshar `find . -print` \&| mail -s "ls source" rick 879b50d902SRodney W. Grimes.Ed 889b50d902SRodney W. Grimes.Pp 899b50d902SRodney W. GrimesTo recreate the program directory: 909b50d902SRodney W. Grimes.Bd -literal -offset indent 919b50d902SRodney W. Grimesmkdir ls 929b50d902SRodney W. Grimescd ls 939b50d902SRodney W. Grimes... 949b50d902SRodney W. Grimes<delete header lines and examine mailed archive> 959b50d902SRodney W. Grimes... 969b50d902SRodney W. Grimessh archive 979b50d902SRodney W. Grimes.Ed 989b50d902SRodney W. Grimes.Sh HISTORY 999b50d902SRodney W. GrimesThe 1009b50d902SRodney W. Grimes.Nm 1019b50d902SRodney W. Grimescommand appears in 1029b50d902SRodney W. Grimes.Bx 4.4 . 103