* See {@link ConfigurableFilePermissions#unix(String)} for details,
     * returned value is equivalent to one of the three octal digits.
     */
    protected int toUnixNumeric() {
        return (getRead() ? 4 : 0) + (getWrite() ? 2 : 0) + (getExecute() ? 1 : 0);
    }

    protected static boolean isRead(int unixNumeric) {
        return (unixNumeric & 4) >> 2 == 1;
    }

                archiveEntry.setTime(getArchiveTimeFor(fileDetails));
                archiveEntry.setUnixMode(UnixStat.FILE_FLAG | fileDetails.getPermissions().toUnixNumeric());
                zipOutStr.putArchiveEntry(archiveEntry);
                fileDetails.copyTo(zipOutStr);
                zipOutStr.closeArchiveEntry();
            } catch (Exception e) {

                .willBeRemovedInGradle9()
                .withUpgradeGuideSection(8, "unix_file_permissions_deprecated")
                .nagUser();
            return getPermissions().toUnixNumeric();
        }

        @Override
        public FilePermissions getPermissions() {
            int unixNumeric = stat.getUnixMode(getFile());
            return new DefaultFilePermissions(unixNumeric);

            adaptPermissions(target);
            return copied;
        }
    }

    private void adaptPermissions(File target) {
        int specMode = this.getPermissions().toUnixNumeric();
        getChmod().chmod(target, specMode);
    }

    @Override
    public RelativePath getRelativePath() {
        if (relativePath == null) {

    /**
     * Converts the permissions for the various user groups to a numeric Unix permission.
     * See {@link ConfigurableFilePermissions#unix(String)} for details.
     */
    int toUnixNumeric();

    }

    static void assertVisitsPermissions(FileTree tree, Map<String, Integer> filesWithPermissions) {
        def visited = [:]
        tree.visit {
            visited[it.name] = it.permissions.toUnixNumeric()
        }
        assertThat(visited, equalTo(filesWithPermissions))
    }

                .willBeRemovedInGradle9()
                .withUpgradeGuideSection(8, "unix_file_permissions_deprecated")
                .nagUser();
            return getPermissions().toUnixNumeric();
        }

        @Override
        public FilePermissions getPermissions() {
            int unixNumeric = stat.getUnixMode(file);
            return new DefaultFilePermissions(unixNumeric);
        }

            getInputs().property(specPropertyName + ".dirPermissions", spec.getDirPermissions().map(FilePermissions::toUnixNumeric))
                .optional(true);
            getInputs().property(specPropertyName + ".filePermissions", spec.getFilePermissions().map(FilePermissions::toUnixNumeric))
                .optional(true);

        return getMode(buildRootResolver().getFilePermissions());
    }

    @Nullable
    private Integer getMode(Provider<ConfigurableFilePermissions> permissions) {
        return permissions.map(FilePermissions::toUnixNumeric).getOrNull();
    }

    @Override
    @Deprecated
    public CopyProcessingSpec setDirMode(@Nullable Integer mode) {
        DeprecationLogger.deprecateMethod(CopyProcessingSpec.class, "setDirMode(Integer)")

                                eachFile {
                                    permissions = p
                                }
                              """
        "file mode"         | "fileMode = p.toUnixNumeric()"
        "file permissions"  | "filePermissions.set(p)"
    }

    private def withSourceFiles(String permissions) {
        file("files/sub/a.txt").createFile().setPermissions(permissions)