# rmamonts/nfs-mamont architecture

> Architecture diagram of the GitHub repository rmamonts/nfs-mamont, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rmamonts/nfs-mamont
- Repository: https://github.com/rmamonts/nfs-mamont

## Overview

NFS Mamont is an asynchronous user-space NFSv3, MOUNT, and NLM protocol library. Its main server workflow reads framed RPC calls, parses protocol arguments, dispatches requests to filesystem or mount/lock handling, then serializes replies. The pluggable VFS backend supplies filesystem behavior; the library also exposes client-side argument serializers, RPC service discovery, and a reusable buffer allocator. Edges are limited to relationships documented in the README or visible in the supplied source index; several internal dispatch details were not sampled.

Main entry points: [`nfs-mamont/src/task/connection/read.rs`](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/task/connection/read.rs) (Connection reader), [`nfs-mamont/src/parser/parser_struct.rs`](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/parser/parser_struct.rs) (RPC parser), [`nfs-mamont/src/task/global/vfs.rs`](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/task/global/vfs.rs) (NFS dispatcher), [`nfs-mamont/src/backend.rs`](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/backend.rs) (Backend registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_transport["RPC transport"]
  node_connection["Connection reader<br/>[read.rs]"]
  node_parser["RPC parser<br/>[parser_struct.rs]"]
  node_xdr["XDR primitives<br/>[primitive.rs]"]
  node_serializer["Reply serializer"]
  node_client_serializer["Request serializer"]
  node_rpcbind["RPC discovery<br/>[mod.rs]"]
end

subgraph group_protocols["Protocol handling"]
  node_vfs_dispatch["NFS dispatcher<br/>[vfs.rs]"]
  node_mount_service["Mount procedures<br/>[mod.rs]"]
  node_mount_api["Mount interface<br/>[mod.rs]"]
  node_nlm_task["Lock dispatcher<br/>[nlm_task.rs]"]
  node_nlm_service["Lock procedures"]
  node_nlm_types["Lock protocol types<br/>[lock.rs]"]
  node_nfs_protocol["NFSv3 procedures<br/>[nfsv3.rs]"]
  node_mount_protocol["MOUNT procedures<br/>[mount.rs]"]
  node_nlm_protocol["NLM protocol<br/>[nlm.rs]"]
end

subgraph group_filesystem["Filesystem services"]
  node_vfs["VFS operations"]
  node_backend["Backend registry<br/>[backend.rs]"]
  node_handles["File handles<br/>[file.rs]"]
end

subgraph group_support["Runtime support"]
  node_allocator["Buffer allocator<br/>[mod.rs]"]
  node_context["Server context<br/>[context.rs]"]
  node_auth["RPC credentials<br/>[auth.rs]"]
end

node_client(("NFS client"))

node_client -->|"sends RPC"| node_connection
node_connection -->|"parses calls"| node_parser
node_parser -->|"decodes values"| node_xdr
node_connection -->|"dispatches requests"| node_vfs_dispatch
node_connection -->|"dispatches mount"| node_mount_service
node_connection -->|"dispatches locks"| node_nlm_task
node_vfs_dispatch -->|"calls operations"| node_vfs
node_vfs_dispatch -->|"selects backend"| node_backend
node_backend -->|"implements interface"| node_vfs
node_mount_service -->|"uses procedures"| node_mount_api
node_nlm_task -->|"handles lock calls"| node_nlm_types
node_nlm_service -->|"uses lock types"| node_nlm_types
node_parser -->|"parses procedures"| node_nfs_protocol
node_mount_api -->|"defines procedures"| node_mount_protocol
node_nlm_types -->|"uses protocol constants"| node_nlm_protocol
node_serializer -->|"serializes results"| node_vfs
node_connection -.->|"writes replies"| node_serializer
node_client -->|"encodes requests"| node_client_serializer
node_client_serializer -.->|"sends encoded calls"| node_connection
node_rpcbind -->|"uses RPC parsing"| node_parser
node_context -->|"configures buffers"| node_allocator
node_context -->|"configures backend"| node_backend
node_context -->|"configures dispatch"| node_vfs_dispatch
node_handles -->|"identifies owner"| node_backend
node_parser -.->|"validates credentials"| node_auth
node_connection -->|"allocates buffers"| node_allocator
node_nlm_task -->|"uses buffers"| node_allocator

click node_connection "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/task/connection/read.rs"
click node_parser "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/parser/parser_struct.rs"
click node_xdr "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/parser/primitive.rs"
click node_serializer "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/serializer/server/serialize_struct.rs"
click node_client_serializer "https://github.com/rmamonts/nfs-mamont/tree/main/nfs-mamont/src/serializer/client/arguments"
click node_rpcbind "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/rpcbind/mod.rs"
click node_vfs_dispatch "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/task/global/vfs.rs"
click node_mount_service "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/service/mount/mod.rs"
click node_mount_api "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/mount/mod.rs"
click node_nlm_task "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/task/global/nlm/nlm_task.rs"
click node_nlm_service "https://github.com/rmamonts/nfs-mamont/tree/main/nfs-mamont/src/service/nlm"
click node_nlm_types "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/nlm/lock.rs"
click node_vfs "https://github.com/rmamonts/nfs-mamont/tree/main/nfs-mamont/src/vfs"
click node_backend "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/backend.rs"
click node_handles "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/vfs/file.rs"
click node_allocator "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/allocator/mod.rs"
click node_context "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/context.rs"
click node_auth "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/rpc/auth.rs"
click node_nfs_protocol "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/consts/nfsv3.rs"
click node_mount_protocol "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/consts/mount.rs"
click node_nlm_protocol "https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/consts/nlm.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_connection,node_parser,node_xdr,node_serializer,node_client_serializer,node_rpcbind,node_client toneBlue
class node_vfs_dispatch,node_mount_service,node_mount_api,node_nlm_task,node_nlm_service,node_nlm_types,node_nfs_protocol,node_mount_protocol,node_nlm_protocol toneAmber
class node_vfs,node_backend,node_handles toneMint
class node_allocator,node_context,node_auth toneRose
```

## Components

### RPC transport

- [Connection reader](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/task/connection/read.rs): `nfs-mamont/src/task/connection/read.rs`
- [RPC parser](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/parser/parser_struct.rs): `nfs-mamont/src/parser/parser_struct.rs`
- [XDR primitives](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/parser/primitive.rs): `nfs-mamont/src/parser/primitive.rs`
- [Reply serializer](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/serializer/server/serialize_struct.rs): `nfs-mamont/src/serializer/server/serialize_struct.rs`
- [Request serializer](https://github.com/rmamonts/nfs-mamont/tree/main/nfs-mamont/src/serializer/client/arguments): `nfs-mamont/src/serializer/client/arguments`
- [RPC discovery](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/rpcbind/mod.rs): `nfs-mamont/src/rpcbind/mod.rs`

### Protocol handling

- [NFS dispatcher](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/task/global/vfs.rs): `nfs-mamont/src/task/global/vfs.rs`
- [Mount procedures](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/service/mount/mod.rs): `nfs-mamont/src/service/mount/mod.rs`
- [Mount interface](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/mount/mod.rs): `nfs-mamont/src/mount/mod.rs`
- [Lock dispatcher](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/task/global/nlm/nlm_task.rs): `nfs-mamont/src/task/global/nlm/nlm_task.rs`
- [Lock procedures](https://github.com/rmamonts/nfs-mamont/tree/main/nfs-mamont/src/service/nlm): `nfs-mamont/src/service/nlm`
- [Lock protocol types](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/nlm/lock.rs): `nfs-mamont/src/nlm/lock.rs`
- [NFSv3 procedures](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/consts/nfsv3.rs): `nfs-mamont/src/consts/nfsv3.rs`
- [MOUNT procedures](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/consts/mount.rs): `nfs-mamont/src/consts/mount.rs`
- [NLM protocol](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/consts/nlm.rs): `nfs-mamont/src/consts/nlm.rs`

### Filesystem services

- [VFS operations](https://github.com/rmamonts/nfs-mamont/tree/main/nfs-mamont/src/vfs): `nfs-mamont/src/vfs`
- [Backend registry](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/backend.rs): `nfs-mamont/src/backend.rs`
- [File handles](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/vfs/file.rs): `nfs-mamont/src/vfs/file.rs`

### Runtime support

- [Buffer allocator](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/allocator/mod.rs): `nfs-mamont/src/allocator/mod.rs`
- [Server context](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/context.rs): `nfs-mamont/src/context.rs`
- [RPC credentials](https://github.com/rmamonts/nfs-mamont/blob/main/nfs-mamont/src/rpc/auth.rs): `nfs-mamont/src/rpc/auth.rs`

### Other components

- **NFS client**

## Connections

- NFS client → Connection reader: sends RPC
- Connection reader → RPC parser: parses calls (evidence: `nfs-mamont/src/task/connection/read.rs`)
- RPC parser → XDR primitives: decodes values (evidence: `nfs-mamont/src/parser/primitive.rs`)
- Connection reader → NFS dispatcher: dispatches requests (evidence: `nfs-mamont/src/task/connection/read.rs`)
- Connection reader → Mount procedures: dispatches mount (evidence: `nfs-mamont/src/task/connection/read.rs`)
- Connection reader → Lock dispatcher: dispatches locks (evidence: `nfs-mamont/src/task/connection/read.rs`)
- NFS dispatcher → VFS operations: calls operations (evidence: `nfs-mamont/src/task/global/vfs.rs`)
- NFS dispatcher → Backend registry: selects backend (evidence: `nfs-mamont/src/task/global/vfs.rs`)
- Backend registry → VFS operations: implements interface (evidence: `nfs-mamont/src/backend.rs`)
- Mount procedures → Mount interface: uses procedures (evidence: `nfs-mamont/src/service/mount/mod.rs`)
- Lock dispatcher → Lock protocol types: handles lock calls (evidence: `nfs-mamont/src/task/global/nlm/nlm_task.rs`)
- Lock procedures → Lock protocol types: uses lock types (evidence: `nfs-mamont/src/service/nlm/procedures/lock.rs`)
- RPC parser → NFSv3 procedures: parses procedures (evidence: `nfs-mamont/src/parser/parser_struct.rs`)
- Mount interface → MOUNT procedures: defines procedures (evidence: `nfs-mamont/src/mount/mod.rs`)
- Lock protocol types → NLM protocol: uses protocol constants (evidence: `nfs-mamont/src/nlm/mod.rs`)
- Reply serializer → VFS operations: serializes results (evidence: `nfs-mamont/src/serializer/server/serialize_struct.rs`)
- Connection reader → Reply serializer: writes replies
- NFS client → Request serializer: encodes requests
- Request serializer → Connection reader: sends encoded calls
- RPC discovery → RPC parser: uses RPC parsing (evidence: `nfs-mamont/src/rpcbind/mod.rs`)
- Server context → Buffer allocator: configures buffers (evidence: `nfs-mamont/src/context.rs`)
- Server context → Backend registry: configures backend (evidence: `nfs-mamont/src/context.rs`)
- Server context → NFS dispatcher: configures dispatch (evidence: `nfs-mamont/src/context.rs`)
- File handles → Backend registry: identifies owner (evidence: `nfs-mamont/src/vfs/file.rs`)
- RPC parser → RPC credentials: validates credentials (evidence: `nfs-mamont/src/parser/parser_struct.rs`)
- Connection reader → Buffer allocator: allocates buffers (evidence: `nfs-mamont/src/task/connection/read.rs`)
- Lock dispatcher → Buffer allocator: uses buffers (evidence: `nfs-mamont/src/task/global/nlm/nlm_task.rs`)
