dpdk-core 0.1.5

A wrapper around DPDK's core framework
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

// This file is part of dpdk. It is subject to the license terms in the COPYRIGHT file found in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/dpdk/master/COPYRIGHT. No part of dpdk, including this file, may be copied, modified, propagated, or distributed except according to the terms contained in the COPYRIGHT file.
// Copyright © 2016-2018 The developers of dpdk. See the COPYRIGHT file in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/dpdk/master/COPYRIGHT.


/// A trait to dump information to a file, a string, standard out or standard error.
pub trait PrintInformation
{
	/// Print information to standard out.
	#[inline(always)]
	fn print_information_to_standard_out(&self)
	{
		self.print_information_to_stream(unsafe { stdout } as *mut _)
	}
	
	/// Print information to standard error.
	#[inline(always)]
	fn print_information_to_standard_error(&self)
	{
		self.print_information_to_stream(unsafe { stderr } as *mut _)
	}
	
	/// Print information to a file opened for writing.
	#[inline(always)]
	fn print_information_to_file(&self, file: File) -> Result<(), io::Error>
	{
		let file_descriptor = file.into_raw_fd();
		
		const open_flags: ConstCStr = ConstCStr(b"a\0");
		let stream = unsafe { fdopen(file_descriptor, open_flags.as_ptr()) };
		if stream.is_null()
		{
			return Err(io::Error::last_os_error());
		}
		
		self.print_information_to_stream(stream);
		
		match unsafe { fflush(stream) }
		{
			0 => (),
			
			EOF =>
			{
				unsafe { fclose(stream) };
				return Err(io::Error::last_os_error())
			}
			
			unexpected @ _ =>
			{
				unsafe { fclose(stream) };
				panic!("Unexpected result code '{}' from 'fflush'", unexpected)
			}
		}
		
		match unsafe { fclose(stream) }
		{
			0 => Ok(()),
			EOF => Err(io::Error::last_os_error()),
			unexpected @ _ => panic!("Unexpected result code '{}' from 'fclose'", unexpected),
		}
	}
	
	/// Print information to a string.
	#[inline(always)]
	fn print_information_to_c_string(&self) -> Result<CString, io::Error>
	{
		let mut buffer = unsafe { uninitialized() };
		let mut size = unsafe { uninitialized() };
		let stream = unsafe { open_memstream(&mut buffer, &mut size) };
		if stream.is_null()
		{
			return Err(io::Error::last_os_error());
		}
		
		self.print_information_to_stream(stream);
		
		match unsafe { fflush(stream) }
		{
			0 => (),
			
			EOF =>
			{
				unsafe { fclose(stream) };
				unsafe { free(buffer as *mut c_void) };
				return Err(io::Error::last_os_error())
			}
			
			unexpected @ _ =>
			{
				unsafe { fclose(stream) };
				unsafe { free(buffer as *mut c_void) };
				panic!("Unexpected result code '{}' from 'fflush'", unexpected)
			}
		}
		
		match unsafe { fclose(stream) }
		{
			0 => (),
			
			EOF =>
			{
				unsafe { free(buffer as *mut c_void) };
				return Err(io::Error::last_os_error())
			}
			
			unexpected @ _ =>
			{
				unsafe { free(buffer as *mut c_void) };
				panic!("Unexpected result code '{}' from 'fclose'", unexpected)
			}
		}
		
		let c_string = unsafe { CStr::from_ptr(buffer) }.into();
		
		unsafe { free(buffer as *mut c_void) };
		
		Ok(c_string)
	}
	
	#[doc(hidden)]
	#[inline(always)]
	fn print_information_to_stream(&self, stream: *mut FILE);
}