Skip to main content

Linux Common Folder Custodian

Project description

Folder Custodian

https://img.shields.io/pypi/v/fcust.svg https://github.com/Iolaum/fcust/workflows/CI/badge.svg Documentation Status Updates

Linux Common Folder Custodian

  • Free software: GNU General Public License v3

  • Documentation: Read the Docs

Why?

The family computer runs Fedora, has many users and we want to share some files with each other. To achive this we create a shared common folder. This package solves the problems that come with our use case.

Features

This package is intended to perform maintenance over a folder shared across many users in a Fedora Workstation. The folder should belong to a group for which all users are members.

  • Go through a folder’s content and enforce common group ownership.

  • Go through a folder’s content and enforce common group read and write permissions as well as set groupid sticky bit.

  • Provide a command line command with sane defaults for enforcing common folder group ownership and permissions.

  • Write logs to /tmp/fcust/$USER.log.

  • Provides user systemd service to periodically enforce common folder group ownership and permissions. Runs on user log out.

The key problem this package intends to solve is that files moved from one location to another do not inherit proper permissions in the commonly used folder and therefore when another user tries to access them they encounter problems.

Quick Start Guide

  • Install fcust:

    $ sudo dnf copr enable iolaum/fcust
    $ sudo dnf install fcust
  • Manually create a common group and add as members the users that will have access to it. For example:

    $ sudo groupadd family
    $ sudo usermod -a -G family user1
    $ sudo usermod -a -G family user1
  • Create that folder and assign proper permissions:

    $ mkdir /path/to/common/folder/
    $ chown :family /path/to/common/folder/
    $ chmod 2775 /path/to/common/folder/
  • Setup fcust:

    $ fcust setup /path/to/common/folder/
    $ fcust activate
  • In order to run fcust manually on a properly permissioned common folder run:

    $ fcust run /path/to/common/folder/

History

1.0.0 (2020-11-21)

  • Updated package for Fedora 35.

  • Releasing production version.

0.1.1 (2020-11-22)

  • Added ability to see recent service logs.

  • Releasing beta version of feature complete package.

0.0.14 (2020-11-10)

  • Adding functionality to create, start and stop systemd user service

0.0.10 (2020-11-07)

  • F33 release

  • Minor Documentation update

0.0.9 (2020-10-13)

  • Hotfixed log access path bug

0.0.8 (2020-10-10)

  • Draft packaging as a fedora 32 rpm package

0.0.5 (2020-10-07)

  • Added command line command for folder contents permission enformcement

  • Added documentation

0.0.3 (2020-10-05)

  • Alpha version with common folder enformcement functionality.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fcust-1.0.0.tar.gz (21.5 kB view hashes)

Uploaded Source

Built Distribution

fcust-1.0.0-py2.py3-none-any.whl (14.4 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page