Add more examples. (#747)

Add a simple `termios` example, and add more output to the stdio and
time examples.

Author: sunfishcode

examples/stdio.rs

@@ -285,6 +285,17 @@ fn show<Fd: AsFd>(fd: Fd) -> io::Result<()> {
                 term.special_codes[SpecialCodeIndex::VTIME],
                 term.special_codes[SpecialCodeIndex::VMIN]
             );
+            #[cfg(not(any(
+                bsd,
+                solarish,
+                target_os = "aix",
+                target_os = "haiku",
+                target_os = "nto",
+            )))]
+            println!(
+                "         VSWTC={}",
+                term.special_codes[SpecialCodeIndex::VSWTC]
+            );
             println!(
                 "         START={} STOP={} SUSP={} EOL={}",
                 key(term.special_codes[SpecialCodeIndex::VSTART]),

examples/termios.rs

@@ -0,0 +1,49 @@
+//! A command which demonstrates using `tcgetattr` and `tcsetattr` including
+//! enabling raw (press any key) input.
+
+#[cfg(all(not(windows), feature = "termios"))]
+fn main() -> std::io::Result<()> {
+    use rustix::termios::{tcgetattr, tcsetattr, OptionalActions};
+    use std::io::{Read, Write};
+
+    let tty = std::io::stdin();
+    let termios = tcgetattr(&tty)?;
+    println!("Original termios: {:?}", termios);
+
+    print!("Original settings; enter some text: ");
+    std::io::stdout().flush()?;
+    let mut buffer = String::new();
+    let _input = std::io::stdin().read_line(&mut buffer)?;
+
+    tcsetattr(&tty, OptionalActions::Flush, &termios)?;
+
+    print!("Reset original settings; enter some text: ");
+    std::io::stdout().flush()?;
+    let _input = std::io::stdin().read_line(&mut buffer)?;
+
+    let mut raw = termios.clone();
+    raw.make_raw();
+
+    println!("Raw termios: {:?}", raw);
+
+    tcsetattr(&tty, OptionalActions::Flush, &raw)?;
+
+    print!("Raw settings; press any key...");
+    std::io::stdout().flush()?;
+    let mut buf = [0_u8];
+    let _input = std::io::stdin().read(&mut buf)?;
+
+    tcsetattr(&tty, OptionalActions::Flush, &termios)?;
+    println!();
+
+    print!("Reset original settings again; enter some text: ");
+    std::io::stdout().flush()?;
+    let _input = std::io::stdin().read_line(&mut buffer)?;
+
+    Ok(())
+}
+
+#[cfg(any(windows, not(feature = "termios")))]
+fn main() {
+    unimplemented!()
+}

examples/time.rs

@@ -4,13 +4,42 @@
 #[cfg(not(any(windows, target_os = "espidf")))]
 #[cfg(feature = "time")]
 fn main() {
+    use rustix::time::{clock_gettime, ClockId};
+
+    println!("Real time: {:?}", clock_gettime(ClockId::Realtime));
+    println!("Monotonic time: {:?}", clock_gettime(ClockId::Monotonic));
+
+    #[cfg(any(freebsdlike, target_os = "openbsd"))]
+    println!("Uptime: {:?}", clock_gettime(ClockId::Uptime));
+
+    #[cfg(not(any(solarish, target_os = "netbsd", target_os = "redox")))]
     println!(
-        "Real time: {:?}",
-        rustix::time::clock_gettime(rustix::time::ClockId::Realtime)
+        "Process CPU time: {:?}",
+        clock_gettime(ClockId::ProcessCPUTime)
     );
+
+    #[cfg(not(any(solarish, target_os = "netbsd", target_os = "redox")))]
+    println!(
+        "Thread CPU time: {:?}",
+        clock_gettime(ClockId::ThreadCPUTime)
+    );
+
+    #[cfg(any(linux_kernel, target_os = "freebsd"))]
+    println!(
+        "Realtime (coarse): {:?}",
+        clock_gettime(ClockId::RealtimeCoarse)
+    );
+
+    #[cfg(any(linux_kernel, target_os = "freebsd"))]
+    println!(
+        "Monotonic (coarse): {:?}",
+        clock_gettime(ClockId::MonotonicCoarse)
+    );
+
+    #[cfg(linux_kernel)]
     println!(
-        "Monotonic time: {:?}",
-        rustix::time::clock_gettime(rustix::time::ClockId::Monotonic)
+        "Monotonic (raw): {:?}",
+        clock_gettime(ClockId::MonotonicRaw)
     );
 }