2018-02-05 16:05:59 -05:00
|
|
|
package archive // import "github.com/docker/docker/pkg/archive"
|
2014-11-13 15:36:05 -05:00
|
|
|
|
|
|
|
import (
|
2015-05-01 18:01:10 -04:00
|
|
|
"archive/tar"
|
2015-03-05 20:15:11 -05:00
|
|
|
"os"
|
2015-08-10 18:21:30 -04:00
|
|
|
"path/filepath"
|
2015-08-24 17:07:22 -04:00
|
|
|
|
2017-05-31 17:18:04 -04:00
|
|
|
"github.com/docker/docker/pkg/idtools"
|
2015-08-24 17:07:22 -04:00
|
|
|
"github.com/docker/docker/pkg/longpath"
|
2014-11-13 15:36:05 -05:00
|
|
|
)
|
|
|
|
|
2015-08-10 18:21:30 -04:00
|
|
|
// fixVolumePathPrefix does platform specific processing to ensure that if
|
|
|
|
// the path being passed in is not in a volume path format, convert it to one.
|
|
|
|
func fixVolumePathPrefix(srcPath string) string {
|
2015-08-24 17:07:22 -04:00
|
|
|
return longpath.AddPrefix(srcPath)
|
2015-08-10 18:21:30 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
// getWalkRoot calculates the root path when performing a TarWithOptions.
|
2015-12-13 11:00:39 -05:00
|
|
|
// We use a separate function as this is platform specific.
|
2015-08-10 18:21:30 -04:00
|
|
|
func getWalkRoot(srcPath string, include string) string {
|
|
|
|
return filepath.Join(srcPath, include)
|
|
|
|
}
|
|
|
|
|
2015-09-04 08:56:45 -04:00
|
|
|
// CanonicalTarNameForPath returns platform-specific filepath
|
2015-02-17 15:27:07 -05:00
|
|
|
// to canonical posix-style path for tar archival. p is relative
|
|
|
|
// path.
|
2018-06-27 15:07:17 -04:00
|
|
|
func CanonicalTarNameForPath(p string) string {
|
|
|
|
return filepath.ToSlash(p)
|
2015-02-17 15:27:07 -05:00
|
|
|
}
|
|
|
|
|
2015-03-03 21:40:16 -05:00
|
|
|
// chmodTarEntry is used to adjust the file permissions used in tar header based
|
|
|
|
// on the platform the archival is done.
|
|
|
|
func chmodTarEntry(perm os.FileMode) os.FileMode {
|
pkg/archive: strip "write" bits again on Windows
1. Commit 1a22418f9f1573ca8521831d52c8e0562cb3ef8f changed permissions to `0700`
on Windows, or more factually, it removed `rw` (`chmod g-rw,o-rw`) and added
executable bits (`chmod u+x`).
2. This was too restrictive, and b7dc9040f04fe8dacd2f14c6b93d1b0bb6bde333 changed
permissions to only remove the group- and world-writable bits to give read and
execute access to everyone, but setting execute permissions for everyone.
3. However, this also removed the non-permission bits, so 41eb61d5c2a44c745b11ada948034fd3bcc42db5
updated the code to preserve those, and keep parity with Linux.
This changes it back to `2.`. I wonder (_think_) _permission_ bits (read, write)
can be portable, except for the _executable_ bit (which is not present on Windows).
The alternative could be to keep the permission bits, and only set the executable
bit (`perm | 0111`) for everyone (equivalent of `chmod +x`), but that likely would
be a breaking change.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2022-09-05 04:50:10 -04:00
|
|
|
// Remove group- and world-writable bits.
|
|
|
|
perm &= 0o755
|
|
|
|
|
2022-08-30 09:52:32 -04:00
|
|
|
// Add the x bit: make everything +x on Windows
|
pkg/archive: strip "write" bits again on Windows
1. Commit 1a22418f9f1573ca8521831d52c8e0562cb3ef8f changed permissions to `0700`
on Windows, or more factually, it removed `rw` (`chmod g-rw,o-rw`) and added
executable bits (`chmod u+x`).
2. This was too restrictive, and b7dc9040f04fe8dacd2f14c6b93d1b0bb6bde333 changed
permissions to only remove the group- and world-writable bits to give read and
execute access to everyone, but setting execute permissions for everyone.
3. However, this also removed the non-permission bits, so 41eb61d5c2a44c745b11ada948034fd3bcc42db5
updated the code to preserve those, and keep parity with Linux.
This changes it back to `2.`. I wonder (_think_) _permission_ bits (read, write)
can be portable, except for the _executable_ bit (which is not present on Windows).
The alternative could be to keep the permission bits, and only set the executable
bit (`perm | 0111`) for everyone (equivalent of `chmod +x`), but that likely would
be a breaking change.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2022-09-05 04:50:10 -04:00
|
|
|
return perm | 0o111
|
2015-03-03 21:40:16 -05:00
|
|
|
}
|
|
|
|
|
2017-03-15 18:28:06 -04:00
|
|
|
func setHeaderForSpecialDevice(hdr *tar.Header, name string, stat interface{}) (err error) {
|
|
|
|
// do nothing. no notion of Rdev, Nlink in stat on Windows
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
func getInodeFromStat(stat interface{}) (inode uint64, err error) {
|
|
|
|
// do nothing. no notion of Inode in stat on Windows
|
2014-11-13 15:36:05 -05:00
|
|
|
return
|
|
|
|
}
|
2015-05-07 18:14:11 -04:00
|
|
|
|
|
|
|
// handleTarTypeBlockCharFifo is an OS-specific helper function used by
|
|
|
|
// createTarFile to handle the following types of header: Block; Char; Fifo
|
|
|
|
func handleTarTypeBlockCharFifo(hdr *tar.Header, path string) error {
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
func handleLChmod(hdr *tar.Header, path string, hdrInfo os.FileInfo) error {
|
|
|
|
return nil
|
|
|
|
}
|
2015-10-08 11:51:41 -04:00
|
|
|
|
2017-11-16 01:20:33 -05:00
|
|
|
func getFileUIDGID(stat interface{}) (idtools.Identity, error) {
|
2015-10-08 11:51:41 -04:00
|
|
|
// no notion of file ownership mapping yet on Windows
|
2017-11-16 01:20:33 -05:00
|
|
|
return idtools.Identity{UID: 0, GID: 0}, nil
|
2015-10-08 11:51:41 -04:00
|
|
|
}
|