Function createOrUpdateLink

cli/plugins/util.go:146–178

(binDir, binary, plugin string)

}

func createOrUpdateLink(binDir, binary, plugin string) error {
	var op errors.Op = "plugins.createOrUpdateLink"
	dst := filepath.Join(binDir, PluginNameToBin(plugin, IsWindows()))

	if err := removeLink(dst); err != nil {
		return errors.E(op, fmt.Errorf("failed to remove old symlink: %w", err))
	}
	if _, err := os.Stat(binary); stderrors.Is(err, fs.ErrNotExist) {
		return errors.E(op, fmt.Errorf("can't create symbolic link, source binary (%q) cannot be found in extracted archive: %w", binary, err))
	}

	// Create new
	if err := os.Symlink(binary, dst); err != nil {
		if IsWindows() {
			// If cloning the symlink fails on Windows because the user
			// does not have the required privileges, ignore the error and
			// fall back to copying the file contents.
			//
			// ERROR_PRIVILEGE_NOT_HELD is 1314 (0x522):
			// https://msdn.microsoft.com/en-us/library/windows/desktop/ms681385(v=vs.85).aspx
			var lerr *os.LinkError
			if stderrors.As(err, &lerr); lerr.Err != syscall.Errno(1314) {
				return errors.E(op, err)
			}
			if err := copyFile(binary, dst, 0755); err != nil {
				return errors.E(op, err)
			}
		} else {
			return errors.E(op, fmt.Errorf("failed to create a symlink from %q to %q: %w", binary, dst, err))
		}
	}
	return nil
}

// removeLink removes a symlink reference if exists.
func removeLink(path string) error {