simple/
simple.rs

1// Take a look at the license at the top of the repository in the LICENSE file.
2
3#![crate_type = "bin"]
4#![allow(unused_must_use, non_upper_case_globals)]
5#![allow(clippy::manual_range_contains)]
6
7use std::io::{self, BufRead, Write};
8use std::str::FromStr;
9use sysinfo::{Components, Disks, Networks, Pid, Signal, System, Users};
10
11const signals: &[Signal] = &[
12    Signal::Hangup,
13    Signal::Interrupt,
14    Signal::Quit,
15    Signal::Illegal,
16    Signal::Trap,
17    Signal::Abort,
18    Signal::Bus,
19    Signal::FloatingPointException,
20    Signal::Kill,
21    Signal::User1,
22    Signal::Segv,
23    Signal::User2,
24    Signal::Pipe,
25    Signal::Alarm,
26    Signal::Term,
27    Signal::Child,
28    Signal::Continue,
29    Signal::Stop,
30    Signal::TSTP,
31    Signal::TTIN,
32    Signal::TTOU,
33    Signal::Urgent,
34    Signal::XCPU,
35    Signal::XFSZ,
36    Signal::VirtualAlarm,
37    Signal::Profiling,
38    Signal::Winch,
39    Signal::IO,
40    Signal::Power,
41    Signal::Sys,
42];
43
44fn print_help() {
45    writeln!(&mut io::stdout(), "== Help menu ==");
46    writeln!(&mut io::stdout(), "help               : show this menu");
47    writeln!(
48        &mut io::stdout(),
49        "signals            : show the available signals"
50    );
51    writeln!(
52        &mut io::stdout(),
53        "refresh            : reloads all processes information"
54    );
55    writeln!(
56        &mut io::stdout(),
57        "refresh [pid]      : reloads corresponding process information"
58    );
59    writeln!(
60        &mut io::stdout(),
61        "refresh_components : reloads components information"
62    );
63    writeln!(
64        &mut io::stdout(),
65        "refresh_cpu        : reloads CPU information"
66    );
67    writeln!(
68        &mut io::stdout(),
69        "refresh_disks      : reloads disks information"
70    );
71    writeln!(
72        &mut io::stdout(),
73        "refresh_users      : reloads users information"
74    );
75    writeln!(
76        &mut io::stdout(),
77        "refresh_networks   : reloads networks information"
78    );
79    writeln!(
80        &mut io::stdout(),
81        "show [pid | name]  : show information of the given process \
82         corresponding to [pid | name]"
83    );
84    writeln!(
85        &mut io::stdout(),
86        "kill [pid] [signal]: send [signal] to the process with this \
87         [pid]. 0 < [signal] < 32"
88    );
89    writeln!(
90        &mut io::stdout(),
91        "cpus               : Displays CPUs state"
92    );
93    writeln!(
94        &mut io::stdout(),
95        "memory             : Displays memory state"
96    );
97    writeln!(
98        &mut io::stdout(),
99        "temperature        : Displays components' temperature"
100    );
101    writeln!(
102        &mut io::stdout(),
103        "disks              : Displays disks' information"
104    );
105    writeln!(
106        &mut io::stdout(),
107        "network            : Displays network' information"
108    );
109    writeln!(
110        &mut io::stdout(),
111        "all                : Displays all process name and pid"
112    );
113    writeln!(
114        &mut io::stdout(),
115        "uptime             : Displays system uptime"
116    );
117    writeln!(
118        &mut io::stdout(),
119        "boot_time          : Displays system boot time"
120    );
121    writeln!(
122        &mut io::stdout(),
123        "vendor_id          : Displays CPU vendor id"
124    );
125    writeln!(&mut io::stdout(), "brand              : Displays CPU brand");
126    writeln!(
127        &mut io::stdout(),
128        "load_avg           : Displays system load average"
129    );
130    writeln!(
131        &mut io::stdout(),
132        "frequency          : Displays CPU frequency"
133    );
134    writeln!(
135        &mut io::stdout(),
136        "users              : Displays all users and their groups"
137    );
138    writeln!(
139        &mut io::stdout(),
140        "system             : Displays system information (such as name, version and hostname)"
141    );
142    writeln!(
143        &mut io::stdout(),
144        "pid                : Display this example's PID"
145    );
146
147    writeln!(&mut io::stdout(), "quit               : Exit the program");
148}
149
150fn interpret_input(
151    input: &str,
152    sys: &mut System,
153    networks: &mut Networks,
154    disks: &mut Disks,
155    components: &mut Components,
156    users: &mut Users,
157) -> bool {
158    match input.trim() {
159        "help" => print_help(),
160        "refresh_disks" => {
161            writeln!(&mut io::stdout(), "Refreshing disk list...");
162            disks.refresh(true);
163            writeln!(&mut io::stdout(), "Done.");
164        }
165        "refresh_users" => {
166            writeln!(&mut io::stdout(), "Refreshing user list...");
167            users.refresh();
168            writeln!(&mut io::stdout(), "Done.");
169        }
170        "refresh_networks" => {
171            writeln!(&mut io::stdout(), "Refreshing network list...");
172            networks.refresh(true);
173            writeln!(&mut io::stdout(), "Done.");
174        }
175        "refresh_components" => {
176            writeln!(&mut io::stdout(), "Refreshing component list...");
177            components.refresh(true);
178            writeln!(&mut io::stdout(), "Done.");
179        }
180        "refresh_cpu" => {
181            writeln!(&mut io::stdout(), "Refreshing CPUs...");
182            sys.refresh_cpu_all();
183            writeln!(&mut io::stdout(), "Done.");
184        }
185        "signals" => {
186            let mut nb = 1i32;
187
188            for sig in signals {
189                writeln!(&mut io::stdout(), "{nb:2}:{sig:?}");
190                nb += 1;
191            }
192        }
193        "cpus" => {
194            // Note: you should refresh a few times before using this, so that usage statistics
195            // can be ascertained
196            writeln!(
197                &mut io::stdout(),
198                "number of physical cores: {}",
199                System::physical_core_count()
200                    .map(|c| c.to_string())
201                    .unwrap_or_else(|| "Unknown".to_owned()),
202            );
203            writeln!(
204                &mut io::stdout(),
205                "total CPU usage: {}%",
206                sys.global_cpu_usage(),
207            );
208            for cpu in sys.cpus() {
209                writeln!(&mut io::stdout(), "{cpu:?}");
210            }
211        }
212        "memory" => {
213            writeln!(
214                &mut io::stdout(),
215                "total memory:     {: >10} KB",
216                sys.total_memory() / 1_000
217            );
218            writeln!(
219                &mut io::stdout(),
220                "available memory: {: >10} KB",
221                sys.available_memory() / 1_000
222            );
223            writeln!(
224                &mut io::stdout(),
225                "used memory:      {: >10} KB",
226                sys.used_memory() / 1_000
227            );
228            writeln!(
229                &mut io::stdout(),
230                "total swap:       {: >10} KB",
231                sys.total_swap() / 1_000
232            );
233            writeln!(
234                &mut io::stdout(),
235                "used swap:        {: >10} KB",
236                sys.used_swap() / 1_000
237            );
238        }
239        "quit" | "exit" => return true,
240        "all" => {
241            for (pid, proc_) in sys.processes() {
242                writeln!(
243                    &mut io::stdout(),
244                    "{}:{} status={:?}",
245                    pid,
246                    proc_.name().to_string_lossy(),
247                    proc_.status()
248                );
249            }
250        }
251        "frequency" => {
252            for cpu in sys.cpus() {
253                writeln!(
254                    &mut io::stdout(),
255                    "[{}] {} MHz",
256                    cpu.name(),
257                    cpu.frequency(),
258                );
259            }
260        }
261        "vendor_id" => {
262            writeln!(
263                &mut io::stdout(),
264                "vendor ID: {}",
265                sys.cpus()[0].vendor_id()
266            );
267        }
268        "brand" => {
269            writeln!(&mut io::stdout(), "brand: {}", sys.cpus()[0].brand());
270        }
271        "load_avg" => {
272            let load_avg = System::load_average();
273            writeln!(&mut io::stdout(), "one minute     : {}%", load_avg.one);
274            writeln!(&mut io::stdout(), "five minutes   : {}%", load_avg.five);
275            writeln!(&mut io::stdout(), "fifteen minutes: {}%", load_avg.fifteen);
276        }
277        e if e.starts_with("show ") => {
278            let tmp: Vec<&str> = e.split(' ').collect();
279
280            if tmp.len() != 2 {
281                writeln!(
282                    &mut io::stdout(),
283                    "show command takes a pid or a name in parameter!"
284                );
285                writeln!(&mut io::stdout(), "example: show 1254");
286            } else if let Ok(pid) = Pid::from_str(tmp[1]) {
287                match sys.process(pid) {
288                    Some(p) => {
289                        writeln!(&mut io::stdout(), "{:?}", *p);
290                        writeln!(
291                            &mut io::stdout(),
292                            "Files open/limit: {:?}/{:?}",
293                            p.open_files(),
294                            p.open_files_limit(),
295                        );
296                    }
297                    None => {
298                        writeln!(&mut io::stdout(), "pid \"{pid:?}\" not found");
299                    }
300                }
301            } else {
302                let proc_name = tmp[1];
303                for proc_ in sys.processes_by_name(proc_name.as_ref()) {
304                    writeln!(
305                        &mut io::stdout(),
306                        "==== {} ====",
307                        proc_.name().to_string_lossy()
308                    );
309                    writeln!(&mut io::stdout(), "{proc_:?}");
310                }
311            }
312        }
313        "temperature" => {
314            for component in components.iter() {
315                writeln!(&mut io::stdout(), "{component:?}");
316            }
317        }
318        "network" => {
319            for (interface_name, data) in networks.iter() {
320                writeln!(
321                    &mut io::stdout(),
322                    "{}:\n  ether {}\n  input data  (new / total): {} / {} B\n  output data (new / total): {} / {} B",
323                    interface_name,
324                    data.mac_address(),
325                    data.received(),
326                    data.total_received(),
327                    data.transmitted(),
328                    data.total_transmitted(),
329                );
330            }
331        }
332        "show" => {
333            writeln!(
334                &mut io::stdout(),
335                "'show' command expects a pid number or a process name"
336            );
337        }
338        e if e.starts_with("kill ") => {
339            let tmp: Vec<&str> = e.split(' ').collect();
340
341            if tmp.len() != 3 {
342                writeln!(
343                    &mut io::stdout(),
344                    "kill command takes the pid and a signal number in parameter!"
345                );
346                writeln!(&mut io::stdout(), "example: kill 1254 9");
347            } else {
348                let pid = Pid::from_str(tmp[1]).unwrap();
349                let signal = i32::from_str(tmp[2]).unwrap();
350
351                if signal < 1 || signal > 31 {
352                    writeln!(
353                        &mut io::stdout(),
354                        "Signal must be between 0 and 32 ! See the signals list with the \
355                         signals command"
356                    );
357                } else {
358                    match sys.process(pid) {
359                        Some(p) => {
360                            if let Some(res) =
361                                p.kill_with(*signals.get(signal as usize - 1).unwrap())
362                            {
363                                writeln!(&mut io::stdout(), "kill: {res}");
364                            } else {
365                                writeln!(
366                                    &mut io::stdout(),
367                                    "kill: signal not supported on this platform"
368                                );
369                            }
370                        }
371                        None => {
372                            writeln!(&mut io::stdout(), "pid not found");
373                        }
374                    };
375                }
376            }
377        }
378        "disks" => {
379            for disk in disks {
380                writeln!(&mut io::stdout(), "{disk:?}");
381            }
382        }
383        "users" => {
384            for user in users {
385                writeln!(
386                    &mut io::stdout(),
387                    "{:?} => {:?}",
388                    user.name(),
389                    user.groups()
390                );
391            }
392        }
393        "boot_time" => {
394            writeln!(&mut io::stdout(), "{} seconds", System::boot_time());
395        }
396        "uptime" => {
397            let up = System::uptime();
398            let mut uptime = up;
399            let days = uptime / 86400;
400            uptime -= days * 86400;
401            let hours = uptime / 3600;
402            uptime -= hours * 3600;
403            let minutes = uptime / 60;
404            writeln!(
405                &mut io::stdout(),
406                "{days} days {hours} hours {minutes} minutes ({up} seconds in total)",
407            );
408        }
409        x if x.starts_with("refresh") => {
410            if x == "refresh" {
411                writeln!(&mut io::stdout(), "Getting processes' information...");
412                sys.refresh_all();
413                writeln!(&mut io::stdout(), "Done.");
414            } else if x.starts_with("refresh ") {
415                writeln!(&mut io::stdout(), "Getting process' information...");
416                if let Some(pid) = x
417                    .split(' ')
418                    .filter_map(|pid| pid.parse().ok())
419                    .take(1)
420                    .next()
421                {
422                    if sys.refresh_processes(sysinfo::ProcessesToUpdate::Some(&[pid]), true) != 0 {
423                        writeln!(&mut io::stdout(), "Process `{pid}` updated successfully");
424                    } else {
425                        writeln!(&mut io::stdout(), "Process `{pid}` couldn't be updated...");
426                    }
427                } else {
428                    writeln!(&mut io::stdout(), "Invalid [pid] received...");
429                }
430            } else {
431                writeln!(
432                    &mut io::stdout(),
433                    "\"{x}\": Unknown command. Enter 'help' if you want to get the commands' \
434                     list.",
435                );
436            }
437        }
438        "pid" => {
439            writeln!(
440                &mut io::stdout(),
441                "PID: {}",
442                sysinfo::get_current_pid().expect("failed to get PID")
443            );
444        }
445        "system" => {
446            writeln!(
447                &mut io::stdout(),
448                "System name:              {}\n\
449                 System kernel version:    {}\n\
450                 System OS version:        {}\n\
451                 System OS (long) version: {}\n\
452                 System host name:         {}\n\
453		 System kernel:            {}",
454                System::name().unwrap_or_else(|| "<unknown>".to_owned()),
455                System::kernel_version().unwrap_or_else(|| "<unknown>".to_owned()),
456                System::os_version().unwrap_or_else(|| "<unknown>".to_owned()),
457                System::long_os_version().unwrap_or_else(|| "<unknown>".to_owned()),
458                System::host_name().unwrap_or_else(|| "<unknown>".to_owned()),
459                System::kernel_long_version(),
460            );
461        }
462        e => {
463            writeln!(
464                &mut io::stdout(),
465                "\"{e}\": Unknown command. Enter 'help' if you want to get the commands' \
466                 list.",
467            );
468        }
469    }
470    false
471}
472
473fn main() {
474    println!("Getting system information...");
475    let mut system = System::new_all();
476    let mut networks = Networks::new_with_refreshed_list();
477    let mut disks = Disks::new_with_refreshed_list();
478    let mut components = Components::new_with_refreshed_list();
479    let mut users = Users::new_with_refreshed_list();
480
481    println!("Done.");
482    let t_stin = io::stdin();
483    let mut stin = t_stin.lock();
484    let mut done = false;
485
486    println!("To get the commands' list, enter 'help'.");
487    while !done {
488        let mut input = String::new();
489        write!(&mut io::stdout(), "> ");
490        io::stdout().flush();
491
492        stin.read_line(&mut input);
493        if input.is_empty() {
494            // The string is empty, meaning there is no '\n', meaning
495            // that the user used CTRL+D so we can just quit!
496            println!("\nLeaving, bye!");
497            break;
498        }
499        if (&input as &str).ends_with('\n') {
500            input.pop();
501        }
502        done = interpret_input(
503            input.as_ref(),
504            &mut system,
505            &mut networks,
506            &mut disks,
507            &mut components,
508            &mut users,
509        );
510    }
511}