tape: change code hierarchy to improve docs

src/tape/changer/mod.rs

@@ -1,3 +1,5 @@
+//! Media changer implementation (SCSI media changer)
+
 mod email;
 pub use email::*;
 
@@ -10,6 +12,9 @@ pub use mtx_wrapper::*;
 mod mtx;
 pub use mtx::*;
 
+mod online_status_map;
+pub use online_status_map::*;
+
 use anyhow::{bail, Error};
 
 /// Interface to the media changer device for a single drive

src/tape/changer/online_status_map.rs

@@ -12,11 +12,13 @@ use crate::{
         ScsiTapeChanger,
     },
     tape::{
-        MediaChange,
         Inventory,
-        MtxStatus,
-        ElementStatus,
-        mtx_status,
+        changer::{
+            MediaChange,
+            MtxStatus,
+            ElementStatus,
+            mtx_status,
+        },
     },
 };
 

src/tape/drive/linux_tape.rs

@@ -26,17 +26,17 @@ use crate::{
     tape::{
         TapeRead,
         TapeWrite,
-        TapeAlertFlags,
-        Lp17VolumeStatistics,
-        read_mam_attributes,
-        mam_extract_media_usage,
-        read_tape_alert_flags,
-        read_volume_statistics,
-        set_encryption,
         drive::{
+            linux_mtio::*,
             LinuxTapeDrive,
             TapeDriver,
-            linux_mtio::*,
+            TapeAlertFlags,
+            Lp17VolumeStatistics,
+            read_mam_attributes,
+            mam_extract_media_usage,
+            read_tape_alert_flags,
+            read_volume_statistics,
+            set_encryption,
         },
         file_formats::{
             PROXMOX_TAPE_BLOCK_SIZE,

src/tape/drive/mam.rs

@@ -10,7 +10,7 @@ use proxmox::tools::io::ReadExt;
 use crate::{
     api2::types::MamAttribute,
     tape::{
-        TapeAlertFlags,
+        drive::TapeAlertFlags,
         sgutils2::SgRaw,
     },
 };

src/tape/drive/mod.rs

@@ -1,3 +1,5 @@
+//! Tape drivers
+
 mod virtual_tape;
 mod linux_mtio;
 
@@ -10,7 +12,8 @@ pub use volume_statistics::*;
 mod encryption;
 pub use encryption::*;
 
-pub mod linux_tape;
+mod linux_tape;
+pub use linux_tape::*;
 
 mod mam;
 pub use mam::*;
@@ -44,7 +47,6 @@ use crate::{
         TapeWrite,
         TapeRead,
         MediaId,
-        MtxMediaChanger,
         file_formats::{
             PROXMOX_BACKUP_MEDIA_LABEL_MAGIC_1_0,
             PROXMOX_BACKUP_MEDIA_SET_LABEL_MAGIC_1_0,
@@ -54,6 +56,7 @@ use crate::{
         },
         changer::{
             MediaChange,
+            MtxMediaChanger,
             send_load_media_email,
         },
     },

src/tape/drive/virtual_tape.rs

@@ -15,10 +15,12 @@ use crate::{
     tape::{
         TapeWrite,
         TapeRead,
-        MtxStatus,
-        DriveStatus,
-        ElementStatus,
-        changer::MediaChange,
+        changer::{
+            MediaChange,
+            MtxStatus,
+            DriveStatus,
+            ElementStatus,
+        },
         drive::{
             VirtualTapeDrive,
             TapeDriver,

src/tape/inventory.rs

@@ -31,12 +31,12 @@ use crate::{
     },
     tape::{
         TAPE_STATUS_DIR,
-        OnlineStatusMap,
         MediaSet,
         file_formats::{
             MediaLabel,
             MediaSetLabel,
         },
+        changer::OnlineStatusMap,
     },
 };
 

src/tape/mod.rs

@@ -26,14 +26,9 @@ pub use media_set::*;
 mod inventory;
 pub use inventory::*;
 
-mod changer;
-pub use changer::*;
+pub mod changer;
 
-mod drive;
-pub use drive::*;
-
-mod online_status_map;
-pub use online_status_map::*;
+pub mod drive;
 
 mod media_pool;
 pub use media_pool::*;

src/tape/pool_writer.rs

@@ -15,7 +15,6 @@ use crate::{
         TAPE_STATUS_DIR,
         MAX_CHUNK_ARCHIVE_SIZE,
         COMMIT_BLOCK_SIZE,
-        TapeDriver,
         TapeWrite,
         ChunkArchiveWriter,
         SnapshotReader,
@@ -25,10 +24,13 @@ use crate::{
         MediaCatalog,
         MediaSetCatalog,
         tape_write_snapshot_archive,
-        request_and_load_media,
-        tape_alert_flags_critical,
-        media_changer,
         file_formats::MediaSetLabel,
+        drive::{
+            TapeDriver,
+            request_and_load_media,
+            tape_alert_flags_critical,
+            media_changer,
+        },
     },
     config::tape_encryption_keys::load_key_configs,
 };