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. 12*fbbd9655SWarner Losh.\" 3. Neither the name of the University nor the names of its contributors 139b50d902SRodney W. Grimes.\" may be used to endorse or promote products derived from this software 149b50d902SRodney W. Grimes.\" without specific prior written permission. 159b50d902SRodney W. Grimes.\" 169b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 179b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 189b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 199b50d902SRodney W. Grimes.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 209b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 219b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 229b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 239b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 249b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 259b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 269b50d902SRodney W. Grimes.\" SUCH DAMAGE. 279b50d902SRodney W. Grimes.\" 289b50d902SRodney W. Grimes.\" @(#)shar.1 8.1 (Berkeley) 6/6/93 29c3aac50fSPeter Wemm.\" $FreeBSD$ 309b50d902SRodney W. Grimes.\" 319b50d902SRodney W. Grimes.Dd June 6, 1993 329b50d902SRodney W. Grimes.Dt SHAR 1 3362500372SRuslan Ermilov.Os 349b50d902SRodney W. Grimes.Sh NAME 359b50d902SRodney W. Grimes.Nm shar 369b50d902SRodney W. Grimes.Nd create a shell archive of files 379b50d902SRodney W. Grimes.Sh SYNOPSIS 38bca89c59SPhilippe Charnier.Nm 39bca89c59SPhilippe Charnier.Ar 409b50d902SRodney W. Grimes.Sh DESCRIPTION 4193e0d62dSJohn-Mark GurneyThe 4293e0d62dSJohn-Mark Gurney.Nm 4393e0d62dSJohn-Mark Gurneycommand writes a 449b50d902SRodney W. Grimes.Xr sh 1 459b50d902SRodney W. Grimesshell script to the standard output which will recreate the file 469b50d902SRodney W. Grimeshierarchy specified by the command line operands. 479b50d902SRodney W. GrimesDirectories will be recreated and must be specified before the 489b50d902SRodney W. Grimesfiles they contain (the 499b50d902SRodney W. Grimes.Xr find 1 509b50d902SRodney W. Grimesutility does this correctly). 519b50d902SRodney W. Grimes.Pp 5293e0d62dSJohn-Mark GurneyThe 5393e0d62dSJohn-Mark Gurney.Nm 5493e0d62dSJohn-Mark Gurneycommand is normally used for distributing files by 559b50d902SRodney W. Grimes.Xr ftp 1 569b50d902SRodney W. Grimesor 579b50d902SRodney W. Grimes.Xr mail 1 . 586c7216dfSRuslan Ermilov.Sh EXAMPLES 596c7216dfSRuslan ErmilovTo create a shell archive of the program 606c7216dfSRuslan Ermilov.Xr ls 1 616c7216dfSRuslan Ermilovand mail it to Rick: 626c7216dfSRuslan Ermilov.Bd -literal -offset indent 636c7216dfSRuslan Ermilovcd ls 646c7216dfSRuslan Ermilovshar `find . -print` \&| mail -s "ls source" rick 656c7216dfSRuslan Ermilov.Ed 666c7216dfSRuslan Ermilov.Pp 676c7216dfSRuslan ErmilovTo recreate the program directory: 686c7216dfSRuslan Ermilov.Bd -literal -offset indent 696c7216dfSRuslan Ermilovmkdir ls 706c7216dfSRuslan Ermilovcd ls 716c7216dfSRuslan Ermilov\&... 726c7216dfSRuslan Ermilov<delete header lines and examine mailed archive> 736c7216dfSRuslan Ermilov\&... 746c7216dfSRuslan Ermilovsh archive 756c7216dfSRuslan Ermilov.Ed 769b50d902SRodney W. Grimes.Sh SEE ALSO 779b50d902SRodney W. Grimes.Xr compress 1 , 789b50d902SRodney W. Grimes.Xr mail 1 , 79da1ff3cbSWolfram Schneider.Xr tar 1 , 80da1ff3cbSWolfram Schneider.Xr uuencode 1 816c7216dfSRuslan Ermilov.Sh HISTORY 826c7216dfSRuslan ErmilovThe 836c7216dfSRuslan Ermilov.Nm 846c7216dfSRuslan Ermilovcommand appeared in 856c7216dfSRuslan Ermilov.Bx 4.4 . 869b50d902SRodney W. Grimes.Sh BUGS 8793e0d62dSJohn-Mark GurneyThe 8893e0d62dSJohn-Mark Gurney.Nm 8993e0d62dSJohn-Mark Gurneycommand makes no provisions for special types of files or files containing 909b50d902SRodney W. Grimesmagic characters. 9193e0d62dSJohn-Mark GurneyThe 9293e0d62dSJohn-Mark Gurney.Nm 9393e0d62dSJohn-Mark Gurneycommand cannot handle files without a newline ('\\n') 945a4db6ebSMike Pritchardas the last character. 959b50d902SRodney W. Grimes.Pp 969b50d902SRodney W. GrimesIt is easy to insert trojan horses into 9793e0d62dSJohn-Mark Gurney.Nm 989b50d902SRodney W. Grimesfiles. 999b50d902SRodney W. GrimesIt is strongly recommended that all shell archive files be examined 1009b50d902SRodney W. Grimesbefore running them through 1019b50d902SRodney W. Grimes.Xr sh 1 . 1029b50d902SRodney W. GrimesArchives produced using this implementation of 10393e0d62dSJohn-Mark Gurney.Nm 1049b50d902SRodney W. Grimesmay be easily examined with the command: 1059b50d902SRodney W. Grimes.Bd -literal -offset indent 1069b50d902SRodney W. Grimesegrep -v '^[X#]' shar.file 1079b50d902SRodney W. Grimes.Ed 108