// Copyright 2019 The Rust Project Developers. See the COPYRIGHT // file at the top-level directory of this distribution and at // http://rust-lang.org/COPYRIGHT. // // Licensed under the Apache License, Version 2.0 or the MIT license // , at your // option. This file may not be copied, modified, or distributed // except according to those terms. //! ncurses-compatible compiled terminfo format parsing (term(5)) use std::collections::HashMap; use std::io; use std::io::prelude::*; use crate::terminfo::Error::*; use crate::terminfo::TermInfo; use crate::Result; pub use crate::terminfo::parser::names::*; // These are the orders ncurses uses in its compiled format (as of 5.9). Not // sure if portable. fn read_le_u16(r: &mut dyn io::Read) -> io::Result { let mut buf = [0; 2]; r.read_exact(&mut buf) .map(|()| u32::from(u16::from_le_bytes(buf))) } fn read_le_u32(r: &mut dyn io::Read) -> io::Result { let mut buf = [0; 4]; r.read_exact(&mut buf).map(|()| u32::from_le_bytes(buf)) } fn read_byte(r: &mut dyn io::Read) -> io::Result { match r.bytes().next() { Some(s) => s, None => Err(io::Error::new(io::ErrorKind::Other, "end of file")), } } /// Parse a compiled terminfo entry, using long capability names if `longnames` /// is true pub fn parse(file: &mut dyn io::Read, longnames: bool) -> Result { let (bnames, snames, nnames) = if longnames { (boolfnames, stringfnames, numfnames) } else { (boolnames, stringnames, numnames) }; // Check magic number let mut buf = [0; 2]; file.read_exact(&mut buf)?; let magic = u16::from_le_bytes(buf); let read_number = match magic { 0x011A => read_le_u16, 0x021e => read_le_u32, _ => return Err(BadMagic(magic).into()), }; // According to the spec, these fields must be >= -1 where -1 means that the // feature is not // supported. Using 0 instead of -1 works because we skip sections with length // 0. macro_rules! read_nonneg { () => {{ match read_le_u16(file)? as i16 { n if n >= 0 => n as usize, -1 => 0, _ => return Err(InvalidLength.into()), } }}; } let names_bytes = read_nonneg!(); let bools_bytes = read_nonneg!(); let numbers_count = read_nonneg!(); let string_offsets_count = read_nonneg!(); let string_table_bytes = read_nonneg!(); if names_bytes == 0 { return Err(ShortNames.into()); } if bools_bytes > boolnames.len() { return Err(TooManyBools.into()); } if numbers_count > numnames.len() { return Err(TooManyNumbers.into()); } if string_offsets_count > stringnames.len() { return Err(TooManyStrings.into()); } // don't read NUL let mut bytes = Vec::new(); file.take((names_bytes - 1) as u64) .read_to_end(&mut bytes)?; let names_str = match String::from_utf8(bytes) { Ok(s) => s, Err(e) => return Err(NotUtf8(e.utf8_error()).into()), }; let term_names: Vec = names_str.split('|').map(|s| s.to_owned()).collect(); // consume NUL if read_byte(file)? != b'\0' { return Err(NamesMissingNull.into()); } let bools_map = (0..bools_bytes) .filter_map(|i| match read_byte(file) { Err(e) => Some(Err(e)), Ok(1) => Some(Ok((bnames[i], true))), Ok(_) => None, }) .collect::>>()?; if (bools_bytes + names_bytes) % 2 == 1 { read_byte(file)?; // compensate for padding } let numbers_map = (0..numbers_count) .filter_map(|i| match read_number(file) { Ok(0xFFFF) => None, Ok(n) => Some(Ok((nnames[i], n))), Err(e) => Some(Err(e)), }) .collect::>>()?; let string_map: HashMap<&str, Vec> = if string_offsets_count > 0 { let string_offsets = (0..string_offsets_count) .map(|_| { let mut buf = [0; 2]; file.read_exact(&mut buf).map(|()| u16::from_le_bytes(buf)) }) .collect::>>()?; let mut string_table = Vec::new(); file.take(string_table_bytes as u64) .read_to_end(&mut string_table)?; string_offsets .into_iter() .enumerate() .filter(|&(_, offset)| { // non-entry offset != 0xFFFF }) .map(|(i, offset)| { let offset = offset as usize; let name = if snames[i] == "_" { stringfnames[i] } else { snames[i] }; if offset == 0xFFFE { // undocumented: FFFE indicates cap@, which means the capability // is not present // unsure if the handling for this is correct return Ok((name, Vec::new())); } // Find the offset of the NUL we want to go to let nulpos = string_table[offset..string_table_bytes] .iter() .position(|&b| b == 0); match nulpos { Some(len) => Ok((name, string_table[offset..offset + len].to_vec())), None => Err(crate::Error::TerminfoParsing(StringsMissingNull)), } }) .collect::>>()? } else { HashMap::new() }; // And that's all there is to it Ok(TermInfo { names: term_names, bools: bools_map, numbers: numbers_map, strings: string_map, }) } #[cfg(test)] mod test { use super::{boolfnames, boolnames, numfnames, numnames, stringfnames, stringnames}; #[test] fn test_veclens() { assert_eq!(boolfnames.len(), boolnames.len()); assert_eq!(numfnames.len(), numnames.len()); assert_eq!(stringfnames.len(), stringnames.len()); } }