mirror of
				https://github.com/torvalds/linux.git
				synced 2025-11-04 02:30:34 +02:00 
			
		
		
		
	This both demonstrates the usage of different print format in Rust and serves as a selftest for the `Display` and `Debug` implementation of `Arc` and its friends. Signed-off-by: Boqun Feng <boqun.feng@gmail.com> Reviewed-by: Björn Roy Baron <bjorn3_gh@protonmail.com> Reviewed-by: Finn Behrens <fin@nyantec.com> Reviewed-by: Vincenzo Palazzo <vincenzopalazzodev@gmail.com> Reviewed-by: Gary Guo <gary@garyguo.net> Reviewed-by: Andreas Hindborg <a.hindborg@samsung.com> Link: https://lore.kernel.org/r/20230207185216.1314638-3-boqun.feng@gmail.com [ Applied suggestions and reworded for fixing title typos. ] Signed-off-by: Miguel Ojeda <ojeda@kernel.org>
		
			
				
	
	
		
			80 lines
		
	
	
	
		
			2.3 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
			
		
		
	
	
			80 lines
		
	
	
	
		
			2.3 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
// SPDX-License-Identifier: GPL-2.0
 | 
						|
 | 
						|
//! Rust printing macros sample.
 | 
						|
 | 
						|
use kernel::pr_cont;
 | 
						|
use kernel::prelude::*;
 | 
						|
 | 
						|
module! {
 | 
						|
    type: RustPrint,
 | 
						|
    name: "rust_print",
 | 
						|
    author: "Rust for Linux Contributors",
 | 
						|
    description: "Rust printing macros sample",
 | 
						|
    license: "GPL",
 | 
						|
}
 | 
						|
 | 
						|
struct RustPrint;
 | 
						|
 | 
						|
fn arc_print() -> Result {
 | 
						|
    use kernel::sync::*;
 | 
						|
 | 
						|
    let a = Arc::try_new(1)?;
 | 
						|
    let b = UniqueArc::try_new("hello, world")?;
 | 
						|
 | 
						|
    // Prints the value of data in `a`.
 | 
						|
    pr_info!("{}", a);
 | 
						|
 | 
						|
    // Uses ":?" to print debug fmt of `b`.
 | 
						|
    pr_info!("{:?}", b);
 | 
						|
 | 
						|
    let a: Arc<&str> = b.into();
 | 
						|
    let c = a.clone();
 | 
						|
 | 
						|
    // Uses `dbg` to print, will move `c` (for temporary debugging purposes).
 | 
						|
    dbg!(c);
 | 
						|
 | 
						|
    // Pretty-prints the debug formatting with lower-case hexadecimal integers.
 | 
						|
    pr_info!("{:#x?}", a);
 | 
						|
 | 
						|
    Ok(())
 | 
						|
}
 | 
						|
 | 
						|
impl kernel::Module for RustPrint {
 | 
						|
    fn init(_module: &'static ThisModule) -> Result<Self> {
 | 
						|
        pr_info!("Rust printing macros sample (init)\n");
 | 
						|
 | 
						|
        pr_emerg!("Emergency message (level 0) without args\n");
 | 
						|
        pr_alert!("Alert message (level 1) without args\n");
 | 
						|
        pr_crit!("Critical message (level 2) without args\n");
 | 
						|
        pr_err!("Error message (level 3) without args\n");
 | 
						|
        pr_warn!("Warning message (level 4) without args\n");
 | 
						|
        pr_notice!("Notice message (level 5) without args\n");
 | 
						|
        pr_info!("Info message (level 6) without args\n");
 | 
						|
 | 
						|
        pr_info!("A line that");
 | 
						|
        pr_cont!(" is continued");
 | 
						|
        pr_cont!(" without args\n");
 | 
						|
 | 
						|
        pr_emerg!("{} message (level {}) with args\n", "Emergency", 0);
 | 
						|
        pr_alert!("{} message (level {}) with args\n", "Alert", 1);
 | 
						|
        pr_crit!("{} message (level {}) with args\n", "Critical", 2);
 | 
						|
        pr_err!("{} message (level {}) with args\n", "Error", 3);
 | 
						|
        pr_warn!("{} message (level {}) with args\n", "Warning", 4);
 | 
						|
        pr_notice!("{} message (level {}) with args\n", "Notice", 5);
 | 
						|
        pr_info!("{} message (level {}) with args\n", "Info", 6);
 | 
						|
 | 
						|
        pr_info!("A {} that", "line");
 | 
						|
        pr_cont!(" is {}", "continued");
 | 
						|
        pr_cont!(" with {}\n", "args");
 | 
						|
 | 
						|
        arc_print()?;
 | 
						|
 | 
						|
        Ok(RustPrint)
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
impl Drop for RustPrint {
 | 
						|
    fn drop(&mut self) {
 | 
						|
        pr_info!("Rust printing macros sample (exit)\n");
 | 
						|
    }
 | 
						|
}
 |