1// Copyright 2014 The Go Authors. All rights reserved. 2// Use of this source code is governed by a BSD-style 3// license that can be found in the LICENSE file. 4 5/* 6Pack is a simple version of the traditional Unix ar tool. 7It implements only the operations needed by Go. 8 9Usage: 10 11 go tool pack op file.a [name...] 12 13Pack applies the operation to the archive, using the names as arguments to the operation. 14 15The operation op is given by one of these letters: 16 17 c append files (from the file system) to a new archive 18 p print files from the archive 19 r append files (from the file system) to the archive 20 t list files from the archive 21 x extract files from the archive 22 23The archive argument to the c command must be non-existent or a 24valid archive file, which will be cleared before adding new entries. It 25is an error if the file exists but is not an archive. 26 27For the p, t, and x commands, listing no names on the command line 28causes the operation to apply to all files in the archive. 29 30In contrast to Unix ar, the r operation always appends to the archive, 31even if a file with the given name already exists in the archive. In this way 32pack's r operation is more like Unix ar's rq operation. 33 34Adding the letter v to an operation, as in pv or rv, enables verbose operation: 35For the c and r commands, names are printed as files are added. 36For the p command, each file is prefixed by the name on a line by itself. 37For the t command, the listing includes additional file metadata. 38For the x command, names are printed as files are extracted. 39*/ 40package main 41