
An open source distributed filesystem.
Showing 5 of 7 projects. Click any project card for scope, mentors, and proposal studio.
Mentors: Student: Minca Maria-Alexandra
This project extends the OpenAFS fs examine command to provide visibility into each component of a given path, instead of only the final object. In a distributed file system, paths may traverse multiple volumes, cells and mount points, making it difficult to understand how a path is resolved. The proposed solution introduces a new optional flag that iteratively resolves each component of a path and retrieves volume and file information using existing pioctl calls. The implementation will handle intermediate path construction, mount point detection, symbolic links and error cases while preserving backward compatibility. The final deliverables include a working implementation of the new flag, support for edge cases such as mount points and symlinks, updated documentation and tests to validate correctness.
Mentors: Student: LaLoutre
Users who want to understand how the AFS cache manager resolves each element of a path (plain directory, mount point, or symlink) must manually run fs examine and fs lsmount on each component separately, or write wrapper scripts. This project implements a new fs pathinfo subcommand in C that walks a given path, iteratively resolves each prefix using the existing pioctl interface (VIOC_AFS_STAT_MT_PT, VIOC_FILE_CELL_INFO, lstat), and reports the type of each component in a human-readable format consistent with existing fs output. Deliverables include: the subcommand implementation integrated into src/venus/fs.c, support for both relative and absolute paths, a -verbose flag, a fs_pathinfo(1) man page in POD format, and a regression test suite covering all major path resolution scenarios.
Mentors: Student: Junsouh Hong
Currently, OpenAFS provides the afsio command that supports read, writes, and locks to both files and directories in the AFS environment without going through the cache manager. However, it does not support mount point control, ACL manipulation, or directory operations, which would allow a fully functional cell to be created without the cache manager; This would be convenient for administrators, as it avoids the kernel module having to be installed on the machine setup is being performed from, as well as allowing setup in environments not compatible with the kernel module. To address this problem, I will implement all three types of subcommands of afsio; Key deliverables include the code for all of these types of commands, as well as documentation such that administrators know how to use them.
Mentors: Student: Sushil Pandey
This project enhances the OpenAFS Linux kernel module with multi-page folio support, addressing a key performance limitation in the current implementation. OpenAFS currently interacts with the Linux kernel's memory management system through single-page operations, despite recent kernel versions offering folio APIs capable of managing multiple contiguous pages as a single unit. I will implement comprehensive multi-page folio support in OpenAFS by modifying key components of the cache manager, particularly focusing on the VFS interface layer where the largest performance benefits can be realized. The implementation will optimize read and write paths to efficiently handle larger memory regions while maintaining backward compatibility with older kernel versions through autoconf detection and conditional compilation. By the end of the project, I will deliver: (1) A complete implementation of multi-page folio support that improves performance, especially for sequential read operations common in application deployment; (2) A comprehensive testing framework verifying functionality across multiple kernel versions; (3) Detailed performance benchmarks demonstrating throughput and resource utilization improvements; and (4) Thorough documentation of implementation details to facilitate future maintenance. All code will be submitted as incremental, well-structured patches adhering to OpenAFS coding standards.
Mentors: Student: Tejas Sonawane
This project aims to develop a GNOME Shell extension that provides a user-friendly graphical interface for managing the OpenAFS client on Linux desktops. OpenAFS, a distributed file system widely used in academic and research environments, currently relies on command-line tools, which can be intimidating for users accustomed to graphical interfaces. The extension will integrate into the GNOME Shell top bar, offering a dropdown menu to start/stop the OpenAFS client, acquire and manage authentication tokens, and display key status information such as token expiration and cell connectivity. Deliverables include a fully functional extension with client control, token management, status indicators, and notifications, all developed using GJS and GNOME Shell APIs. The project will be completed over 12 weeks, with iterative development and testing to ensure a polished, user-friendly tool.