haiku 0.2.0

Implementation of the Haiku API in Rust
Documentation 
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

//
// Copyright 2019, Niels Sascha Reedijk <niels.reedijk@gmail.com>
// All rights reserved. Distributed under the terms of the MIT License.
//

#![allow(non_camel_case_types)]
#![allow(dead_code)]

use std::ffi::CStr;
use std::mem;
use std::path::PathBuf;

use haiku_sys::{image_type, get_next_image_info, image_info, type_code, area_id, port_id, team_id};
use haiku_sys::errors::B_OK;
use libc::c_char;

use ::support::{ErrorKind, HaikuError, Result};

// os/app/AppDefs.h
pub const B_ARGV_RECEIVED: u32 = haiku_constant!('_','A','R','G');
pub const B_READY_TO_RUN: u32 = haiku_constant!('_','R','T','R');
pub const B_QUIT_REQUESTED: u32 = haiku_constant!('_','Q','R','Q');
pub const QUIT: u32 = haiku_constant!('_','Q','I','T');

// private/app/MessagePrivate.h
pub const MESSAGE_FLAG_VALID: u32 = 0x0001;
pub const MESSAGE_FLAG_REPLY_REQUIRED: u32 = 0x0002;
pub const MESSAGE_FLAG_REPLY_DONE: u32 = 0x0004;
pub const MESSAGE_FLAG_IS_REPLY: u32 = 0x0008;
pub const MESSAGE_FLAG_WAS_DELIVERED: u32 = 0x0010;
pub const MESSAGE_FLAG_HAS_SPECIFIERS: u32 = 0x0020;
pub const MESSAGE_FLAG_WAS_DROPPED: u32 = 0x0040;
pub const MESSAGE_FLAG_PASS_BY_AREA: u32 = 0x0080;
pub const MESSAGE_FLAG_REPLY_AS_KMESSAGE: u32 = 0x0100;

pub const FIELD_FLAG_VALID: u16 = 0x0001;
pub const FIELD_FLAG_FIXED_SIZE: u16 = 0x0002;

pub const MESSAGE_FORMAT_HAIKU: u32 = haiku_constant!('1','F','M','H');

// private/app/TokenSpace.h
pub const B_PREFERRED_TOKEN: i32 = -2;
pub const B_NULL_TOKEN: i32 = -1;
pub const B_ANY_TOKEN: i32 = 0;
pub const B_HANDLER_TOKEN: i32 = 1;
pub const B_SERVER_TOKEN: i32 = 2;

#[repr(C)]
#[derive(Copy, Clone)]
pub struct field_header {
	pub flags: u16,
	pub name_length: u16,
	pub field_type: type_code, // The original name 'type' is reserved
	pub count: u32,
	pub data_size: u32,
	pub offset: u32,
	pub next_field: i32
}

#[repr(C)]
#[derive(Copy, Clone)]
pub struct message_header {
	pub message_format: u32,
	pub what: u32,
	pub flags: u32,
	
	pub target: i32,
	pub current_specifier: i32,
	pub message_area: area_id,
	
	pub reply_port: port_id,
	pub reply_target: i32,
	pub reply_team: team_id,
	
	pub data_size: u32,
	pub field_count: u32,
	pub hash_table_size: u32,
	pub hash_table: [i32; 5]
}

// Helper functions
pub(crate) fn get_app_path(team: team_id) -> Result<PathBuf> {
	let mut info: image_info = unsafe { mem::zeroed() };
	let mut cookie: i32 = 0;

	unsafe {
		while get_next_image_info(team, &mut cookie, &mut info) == B_OK {
			if info.image_type == image_type::B_APP_IMAGE {
				let c_name = CStr::from_ptr((&info.name) as *const c_char);
				return Ok(PathBuf::from(c_name.to_str().unwrap()));
			}
		}
	}
	Err(HaikuError::new(ErrorKind::NotFound, "Cannot find the app image"))
}