The checkGpfsAcls command

This tool sets the ACLs of the files given on the command line to those they would inherit from theirparent directories. Directories given on the command line are left unchanged, but all their content is recursively scanned and the ACLs of all their sub-directories and files are set as if freshly inherited. More...

Functions
void	checkAcl (const std::string &path)
void	handleDir (const std::string &path)
int	main (int argc, const char *argv[])

Variables
static unsigned long	nDirs = 0
static unsigned long	nFiles = 0
static options::single< size_t >	maxGoodEntries ('n',"maxGoodEntries", "maximum number of aces in an acl considered good", 14)
static options::single< size_t >	minGoodEntries ('m',"minGoodEntries", "minimum number of aces in an acl considered good", 0)
static std::map< size_t, unsigned long >	aclLength
static std::map< size_t, unsigned long >	multiples

Detailed Description

This tool sets the ACLs of the files given on the command line to those they would inherit from theirparent directories. Directories given on the command line are left unchanged, but all their content is recursively scanned and the ACLs of all their sub-directories and files are set as if freshly inherited.

Function Documentation

checkAcl()

void checkAcl

(

const std::string &

path

)

Definition at line 35 of file checkGpfsAcls.cpp.

                                     {
    gpfs_acl_handler acl;
    acl.get(-1, path);
    unsigned duplicates(0);
    aclLength[acl.size()]++;
    gpfs_ace_v4_t nullAce = {0,0,0,0,0};
 
    for (auto ace1 = acl.begin(); ace1 != acl.end(); ++ace1) {
        for (auto ace2 = ace1 + 1; ace2 != acl.end(); ++ace2) {
            if (!(*ace1 == nullAce) && *ace1 == *ace2) {
                *ace2=nullAce; // mark as already counted
                duplicates++;
            }
        }
    }
    multiples[duplicates]++;
    if (acl.size() > maxGoodEntries || acl.size() < minGoodEntries || duplicates > 0) {
        std::cout << path << " " << acl.size() << " " << duplicates << "\n";
    }
}

References aclLength, maxGoodEntries, minGoodEntries, and multiples.

Referenced by handleDir(), and main().

Here is the caller graph for this function:

handleDir()

void handleDir

(

const std::string &

path

)

Definition at line 56 of file checkGpfsAcls.cpp.

                                      {
    std::forward_list<std::string> subdirs;
    {
        scoped::Dir dir(path);
        while (auto entry = readdir(dir)) {
            if (entry->d_name[entry->d_name[0] != '.' ? 0 : entry->d_name[1] != '.' ? 1 : 2] == '\0') {
                continue; // skip . .. and empty strings
            }
            if (entry->d_type == DT_DIR) {
                subdirs.emplace_front(path + "/" + entry->d_name);
                nDirs++;
            } else if (entry->d_type == DT_REG) {
                std::string filePath(path);
                filePath += "/";
                filePath += entry->d_name;
                nFiles++;
                checkAcl(filePath);
            } else {
                std::cerr << "ignoring '" << entry->d_name << "' in '" << path << "', it's neither dir nor file\n";
            }
        }
    }
    for (const auto& subdir : subdirs) {
        checkAcl(subdir);
        handleDir(subdir);
    }
}

References checkAcl(), nDirs, and nFiles.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

main()

int main	(	int	argc,
		const char *	argv[]
	)

Definition at line 85 of file checkGpfsAcls.cpp.

                                       {
    options::parser parser(
        "set the ACLs of the files given on the command line\n"
        "\t to those they would inherit from theirparent directories.\n"
        "\tDirectories given on the command line are left unchanged,\n"
        "\t but all their content is recursively scanned and the ACLs\n"
        "\t of all their sub-directories and files are set\n"
        "\t as if freshly inherited.\n"
        , "", {});
    options::positional<options::container<std::string>>files(10, "files",
            "files to be checked");
    parser.fParse(argc, argv);
    for (const auto& file : files) {
        struct stat statbuf;
        throwcall::good0(lstat(file.c_str(), &statbuf), "can't stat ", file);
        if (S_ISDIR(statbuf.st_mode)) {
            nDirs++;
            checkAcl(file);
            handleDir(file);
        } else if (S_ISREG(statbuf.st_mode)) {
            nFiles++;
            checkAcl(file);
        } else {
            std::cerr << "ignoring '" << file << "', it's neither dir nor file\n";
        }
    }
    std::cout << "processed " << nFiles << " files in " << nDirs << " directories\n";
    for (const auto& item: aclLength) {
        std::cout << "files with " << item.first << " aces in the acl: " << item.second << "\n";
    }
    for (const auto& item: multiples) {
        std::cout << "files with " << item.first << " duplicates in the acl: " << item.second << "\n";
    }
    return 0;
}

References aclLength, checkAcl(), throwcall::good0(), handleDir(), multiples, nDirs, and nFiles.

Here is the call graph for this function:

Variable Documentation

aclLength

std::map<size_t,unsigned long> aclLength

static

Definition at line 31 of file checkGpfsAcls.cpp.

Referenced by checkAcl(), and main().

maxGoodEntries

options::single<size_t> maxGoodEntries( 'n',"maxGoodEntries", "maximum number of aces in an acl considered good", 14)

static

Referenced by checkAcl().

minGoodEntries

options::single<size_t> minGoodEntries( 'm',"minGoodEntries", "minimum number of aces in an acl considered good", 0)

static

Referenced by checkAcl().

multiples

std::map<size_t,unsigned long> multiples

static

Definition at line 32 of file checkGpfsAcls.cpp.

Referenced by checkAcl(), and main().

nDirs

unsigned long nDirs = 0

static

Definition at line 24 of file checkGpfsAcls.cpp.

Referenced by handleDir(), and main().

nFiles

unsigned long nFiles = 0

static

Definition at line 25 of file checkGpfsAcls.cpp.

Referenced by handleDir(), and main().