// Copyright 2015, 2016 Ethcore (UK) Ltd. // This file is part of Parity. // Parity is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // Parity is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // You should have received a copy of the GNU General Public License // along with Parity. If not, see . //! IPC RPC interface use std::io::{Read, Write}; use std::marker::Sync; use std::sync::atomic::*; pub trait IpcInterface { /// reads the message from io, dispatches the call and returns result fn dispatch(&self, r: &mut R) -> Vec where R: Read; /// deserialize the payload from the io `r` and invokes method specified by `method_num` /// (for non-blocking io) fn dispatch_buf(&self, method_num: u16, buf: &[u8]) -> Vec; } /// serializes method invocation (method_num and parameters) to the stream specified by `w` pub fn invoke(method_num: u16, params: &Option>, w: &mut W) where W: Write { // creating buffer to contain all message let buf_len = match *params { None => 2, Some(ref val) => val.len() + 2 }; let mut buf = vec![0u8; buf_len]; // writing method_num as u16 buf[1] = (method_num & 255) as u8; buf[0] = (method_num >> 8) as u8; // serializing parameters only if provided with any if params.is_some() { buf[2..buf_len].clone_from_slice(params.as_ref().unwrap()); } if w.write(&buf).unwrap() != buf_len { // if write was inconsistent panic!("failed to write to socket"); } } /// IpcSocket pub trait IpcSocket: Read + Write + Sync { fn ready(&self) -> AtomicBool; } impl IpcSocket for ::devtools::TestSocket { fn ready(&self) -> AtomicBool { AtomicBool::new(true) } }