use std::env; use std::os::unix::io::RawFd; use std::path::PathBuf; use std::process::{Child, Command}; use std::sync::{Arc, Mutex}; use zellij_utils::{async_std, interprocess, libc, nix, signal_hook, zellij_tile}; use async_std::fs::File as AsyncFile; use async_std::os::unix::io::FromRawFd; use interprocess::local_socket::LocalSocketStream; use nix::pty::{forkpty, Winsize}; use nix::sys::signal::{kill, Signal}; use nix::sys::termios; use nix::sys::wait::waitpid; use nix::unistd::{self, ForkResult}; use signal_hook::consts::*; use zellij_tile::data::Palette; use zellij_utils::{ errors::ErrorContext, ipc::{ ClientToServerMsg, ExitReason, IpcReceiverWithContext, IpcSenderWithContext, ServerToClientMsg, }, shared::default_palette, }; use async_std::io::ReadExt; pub use async_trait::async_trait; pub use nix::unistd::Pid; pub(crate) fn set_terminal_size_using_fd(fd: RawFd, columns: u16, rows: u16) { // TODO: do this with the nix ioctl use libc::ioctl; use libc::TIOCSWINSZ; let winsize = Winsize { ws_col: columns, ws_row: rows, ws_xpixel: 0, ws_ypixel: 0, }; // TIOCGWINSZ is an u32, but the second argument to ioctl is u64 on // some platforms. When checked on Linux, clippy will complain about // useless conversion. #[allow(clippy::useless_conversion)] unsafe { ioctl(fd, TIOCSWINSZ.into(), &winsize) }; } /// Handle some signals for the child process. This will loop until the child /// process exits. fn handle_command_exit(mut child: Child) { // register the SIGINT signal (TODO handle more signals) let mut signals = signal_hook::iterator::Signals::new(&[SIGINT]).unwrap(); 'handle_exit: loop { // test whether the child process has exited match child.try_wait() { Ok(Some(_status)) => { // if the child process has exited, break outside of the loop // and exit this function // TODO: handle errors? break 'handle_exit; } Ok(None) => { ::std::thread::sleep(::std::time::Duration::from_millis(100)); } Err(e) => panic!("error attempting to wait: {}", e), } for signal in signals.pending() { if let SIGINT = signal { child.kill().unwrap(); child.wait().unwrap(); break 'handle_exit; } } } } /// Spawns a new terminal from the parent terminal with [`termios`](termios::Termios) /// `orig_termios`. /// /// If a `file_to_open` is given, the text editor specified by environment variable `EDITOR` /// (or `VISUAL`, if `EDITOR` is not set) will be started in the new terminal, with the given /// file open. If no file is given, the shell specified by environment variable `SHELL` will /// be started in the new terminal. /// /// # Panics /// /// This function will panic if both the `EDITOR` and `VISUAL` environment variables are not /// set. // FIXME this should probably be split into different functions, or at least have less levels // of indentation in some way fn spawn_terminal(file_to_open: Option, orig_termios: termios::Termios) -> (RawFd, Pid) { let (pid_primary, pid_secondary): (RawFd, Pid) = { match forkpty(None, Some(&orig_termios)) { Ok(fork_pty_res) => { let pid_primary = fork_pty_res.master; let pid_secondary = match fork_pty_res.fork_result { ForkResult::Parent { child } => { // fcntl(pid_primary, FcntlArg::F_SETFL(OFlag::empty())).expect("could not fcntl"); child } ForkResult::Child => match file_to_open { Some(file_to_open) => { if env::var("EDITOR").is_err() && env::var("VISUAL").is_err() { panic!("Can't edit files if an editor is not defined. To fix: define the EDITOR or VISUAL environment variables with the path to your editor (eg. /usr/bin/vim)"); } let editor = env::var("EDITOR").unwrap_or_else(|_| env::var("VISUAL").unwrap()); let child = Command::new(editor) .args(&[file_to_open]) .spawn() .expect("failed to spawn"); handle_command_exit(child); ::std::process::exit(0); } None => { let child = Command::new(env::var("SHELL").unwrap()) .spawn() .expect("failed to spawn"); handle_command_exit(child); ::std::process::exit(0); } }, }; (pid_primary, pid_secondary) } Err(e) => { panic!("failed to fork {:?}", e); } } }; (pid_primary, pid_secondary) } #[derive(Clone)] pub struct ServerOsInputOutput { orig_termios: Arc>, receive_instructions_from_client: Option>>>, send_instructions_to_client: Arc>>>, } // async fn in traits is not supported by rust, so dtolnay's excellent async_trait macro is being // used. See https://smallcultfollowing.com/babysteps/blog/2019/10/26/async-fn-in-traits-are-hard/ #[async_trait] pub trait AsyncReader: Send + Sync { async fn read(&mut self, buf: &mut [u8]) -> Result; } /// An `AsyncReader` that wraps a `RawFd` struct RawFdAsyncReader { fd: async_std::fs::File, } impl RawFdAsyncReader { fn new(fd: RawFd) -> RawFdAsyncReader { RawFdAsyncReader { /// The supplied `RawFd` is consumed by the created `RawFdAsyncReader`, closing it when dropped fd: unsafe { AsyncFile::from_raw_fd(fd) }, } } } #[async_trait] impl AsyncReader for RawFdAsyncReader { async fn read(&mut self, buf: &mut [u8]) -> Result { self.fd.read(buf).await } } /// The `ServerOsApi` trait represents an abstract interface to the features of an operating system that /// Zellij server requires. pub trait ServerOsApi: Send + Sync { /// Sets the size of the terminal associated to file descriptor `fd`. fn set_terminal_size_using_fd(&self, fd: RawFd, cols: u16, rows: u16); /// Spawn a new terminal, with an optional file to open in a terminal program. fn spawn_terminal(&self, file_to_open: Option) -> (RawFd, Pid); /// Read bytes from the standard output of the virtual terminal referred to by `fd`. fn read_from_tty_stdout(&self, fd: RawFd, buf: &mut [u8]) -> Result; /// Creates an `AsyncReader` that can be used to read from `fd` in an async context fn async_file_reader(&self, fd: RawFd) -> Box; /// Write bytes to the standard input of the virtual terminal referred to by `fd`. fn write_to_tty_stdin(&self, fd: RawFd, buf: &[u8]) -> Result; /// Wait until all output written to the object referred to by `fd` has been transmitted. fn tcdrain(&self, fd: RawFd) -> Result<(), nix::Error>; /// Terminate the process with process ID `pid`. fn kill(&self, pid: Pid) -> Result<(), nix::Error>; /// Returns a [`Box`] pointer to this [`ServerOsApi`] struct. fn box_clone(&self) -> Box; /// Receives a message on server-side IPC channel fn recv_from_client(&self) -> (ClientToServerMsg, ErrorContext); /// Sends a message to client fn send_to_client(&self, msg: ServerToClientMsg); /// Adds a sender to client fn add_client_sender(&self); /// Send to the temporary client // A temporary client is the one that hasn't been registered as a client yet. // Only the corresponding router thread has access to send messages to it. // This can be the case when the client cannot attach to the session, // so it tries to connect and then exits, hence temporary. fn send_to_temp_client(&self, msg: ServerToClientMsg); /// Removes the sender to client fn remove_client_sender(&self); /// Update the receiver socket for the client fn update_receiver(&mut self, stream: LocalSocketStream); fn load_palette(&self) -> Palette; } impl ServerOsApi for ServerOsInputOutput { fn set_terminal_size_using_fd(&self, fd: RawFd, cols: u16, rows: u16) { set_terminal_size_using_fd(fd, cols, rows); } fn spawn_terminal(&self, file_to_open: Option) -> (RawFd, Pid) { let orig_termios = self.orig_termios.lock().unwrap(); spawn_terminal(file_to_open, orig_termios.clone()) } fn read_from_tty_stdout(&self, fd: RawFd, buf: &mut [u8]) -> Result { unistd::read(fd, buf) } fn async_file_reader(&self, fd: RawFd) -> Box { Box::new(RawFdAsyncReader::new(fd)) } fn write_to_tty_stdin(&self, fd: RawFd, buf: &[u8]) -> Result { unistd::write(fd, buf) } fn tcdrain(&self, fd: RawFd) -> Result<(), nix::Error> { termios::tcdrain(fd) } fn box_clone(&self) -> Box { Box::new((*self).clone()) } fn kill(&self, pid: Pid) -> Result<(), nix::Error> { // TODO: // Ideally, we should be using SIGINT rather than SIGKILL here, but there are cases in which // the terminal we're trying to kill hangs on SIGINT and so all the app gets stuck // that's why we're sending SIGKILL here // A better solution would be to send SIGINT here and not wait for it, and then have // a background thread do the waitpid stuff and send SIGKILL if the process is stuck kill(pid, Some(Signal::SIGKILL)).unwrap(); waitpid(pid, None).unwrap(); Ok(()) } fn recv_from_client(&self) -> (ClientToServerMsg, ErrorContext) { self.receive_instructions_from_client .as_ref() .unwrap() .lock() .unwrap() .recv() } fn send_to_client(&self, msg: ServerToClientMsg) { self.send_instructions_to_client .lock() .unwrap() .as_mut() .unwrap() .send(msg); } fn add_client_sender(&self) { let sender = self .receive_instructions_from_client .as_ref() .unwrap() .lock() .unwrap() .get_sender(); let old_sender = self .send_instructions_to_client .lock() .unwrap() .replace(sender); if let Some(mut sender) = old_sender { sender.send(ServerToClientMsg::Exit(ExitReason::ForceDetached)); } } fn send_to_temp_client(&self, msg: ServerToClientMsg) { self.receive_instructions_from_client .as_ref() .unwrap() .lock() .unwrap() .get_sender() .send(msg); } fn remove_client_sender(&self) { assert!(self.send_instructions_to_client.lock().unwrap().is_some()); *self.send_instructions_to_client.lock().unwrap() = None; } fn update_receiver(&mut self, stream: LocalSocketStream) { self.receive_instructions_from_client = Some(Arc::new(Mutex::new(IpcReceiverWithContext::new(stream)))); } fn load_palette(&self) -> Palette { default_palette() } } impl Clone for Box { fn clone(&self) -> Box { self.box_clone() } } pub fn get_server_os_input() -> Result { let current_termios = termios::tcgetattr(0)?; let orig_termios = Arc::new(Mutex::new(current_termios)); Ok(ServerOsInputOutput { orig_termios, receive_instructions_from_client: None, send_instructions_to_client: Arc::new(Mutex::new(None)), }) }