CileServer - C File Server

A simple and efficient file server implemented in C.

Features

• Multi-threaded server architecture
• File operations: read, write, delete, list
• Directory operations: create, list
• Configuration system
• Logging system
• Custom binary protocol
• Authentication and authorization

Project Structure

cileserver/
├── config/              # Configuration files
│   └── cileserver.conf  # Example configuration (not tracked in git)
├── docs/                # Documentation
│   ├── architecture.md
│   ├── authentication.md
│   ├── client.md
│   ├── configuration.md
│   ├── file_operations.md
│   ├── index.md
│   ├── logging.md
│   ├── protocol.md
│   ├── server.md
│   └── TODO.md
├── include/             # Header files
├── logs/                # Log files (not tracked in git)
├── src/                 # Source code
├── test_files/          # Test files
├── tests/               # Test scripts
├── builddir/            # Build output directory (not tracked in git)
├── .gitignore
├── install.sh           # Installation script
├── meson.build          # Meson build system
└── README.md            # This file

Note: The config/cileserver.conf file is not tracked in git. You'll need to create your own configuration file based on the example below.

Building

Using Meson

To build the server and client using Meson:

# Run the installation script
./install.sh

Or manually:

# Setup build directory
meson setup builddir

# Build the project
meson compile -C builddir

This will create the executables in the builddir directory.

Running

Server

To run the server:

./builddir/cileserver

Client

To run the client:

./builddir/cileclient [COMMAND] [ARGS]

Available commands:

• list PATH - List directory contents
• get REMOTE_PATH LOCAL_PATH - Download a file
• put REMOTE_PATH LOCAL_PATH - Upload a file
• delete PATH - Delete a file or directory
• mkdir PATH - Create a directory

Server Options

• -p, --port PORT: Port to listen on (default: from config or 9090)
• -c, --config PATH: Path to config file (default: config/cileserver.conf)
• -a, --auth [FILE]: Enable authentication (optional auth file path)
• --no-auth: Disable authentication
• -h, --help: Display help message

You can also specify the config file path directly as the first argument:

./builddir/cileserver config/cileserver.conf

Client Options

• -h, --host HOST: Server hostname (default: localhost)
• -p, --port PORT: Server port (default: 9090)

Configuration

The server requires a configuration file at config/cileserver.conf. This file is not included in the git repository for security reasons, so you'll need to create it yourself.

Example configuration:

# Directory to serve files from
root_directory=/tmp/cileserver

# Maximum number of concurrent connections
max_connections=100

# Port to listen on
port=9090

# Logging level (0=DEBUG, 1=INFO, 2=WARNING, 3=ERROR)
log_level=1

# Enable authentication (0=disabled, 1=enabled)
enable_auth=0

# File containing user credentials
auth_file=users.auth

Documentation

Comprehensive documentation is available in the docs directory:

• Architecture Overview
• Server Implementation
• Client Usage
• Protocol Specification
• File Operations
• Configuration System
• Logging System
• Authentication System
• Project TODO List

Examples

List files in the root directory

./builddir/cileclient list /

Upload a file

./builddir/cileclient put /remote_file.txt local_file.txt

Download a file

./builddir/cileclient get /remote_file.txt downloaded_file.txt

Create a directory

./builddir/cileclient mkdir /new_directory

Delete a file

./builddir/cileclient delete /remote_file.txt

License

This project is licensed under the MIT License - see the LICENSE file for details.