util.h revision 2912:85ea316d9c18 
1/***************************************************************************
2 * CVSID: $Id$
3 *
4 * util.h - Various utilities
5 *
6 * Copyright (C) 2004 David Zeuthen, <david@fubar.dk>
7 *
8 * Licensed under the Academic Free License version 2.1
9 *
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
14 *
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18 * GNU General Public License for more details.
19 *
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
23 *
24 **************************************************************************/
25
26#ifndef UTIL_H
27#define UTIL_H
28
29#include "device.h"
30#include "device_store.h"
31
32#ifndef __FUNCTION__
33#define __FUNCTION__ __func__
34#endif
35
36#ifndef __GNUC__
37#define __attribute__(x)
38#endif
39
40#define HAL_NAME_MAX 256
41#define HAL_PATH_MAX 512
42#define HAL_HELPER_TIMEOUT 10000
43
44gboolean hal_util_remove_trailing_slash (gchar *path);
45
46const gchar *hal_util_get_last_element (const gchar *s);
47
48gchar *hal_util_get_parent_path (const gchar *path);
49
50gchar *hal_util_get_normalized_path (const gchar *path1, const gchar *path2);
51
52gboolean hal_util_get_int_from_file (const gchar *directory, const gchar *file, gint *result, gint base);
53
54gboolean hal_util_set_int_from_file (HalDevice *d, const gchar *key, const gchar *directory, const gchar *file, gint base);
55
56gboolean hal_util_get_uint64_from_file (const gchar *directory, const gchar *file, guint64 *result, gint base);
57
58gboolean hal_util_set_uint64_from_file (HalDevice *d, const gchar *key, const gchar *directory, const gchar *file, gint base);
59
60gchar *hal_util_get_string_from_file (const gchar *directory, const gchar *file);
61
62gboolean hal_util_set_string_from_file (HalDevice *d, const gchar *key, const gchar *directory, const gchar *file);
63
64gboolean hal_util_get_bcd2_from_file (const gchar *directory, const gchar *file, gint *result);
65
66gboolean hal_util_set_bcd2_from_file (HalDevice *d, const gchar *key, const gchar *directory, const gchar *file);
67
68void hal_util_compute_udi (HalDeviceStore *store, gchar *dst, gsize dstsize, const gchar *format, ...);
69
70gboolean hal_util_path_ascend (gchar *path);
71
72void hal_util_grep_discard_existing_data (void);
73
74gchar *hal_util_grep_file (const gchar *directory, const gchar *file, const gchar *linestart, gboolean reuse_file);
75
76gint hal_util_grep_int_elem_from_file (const gchar *directory, const gchar *file,
77				       const gchar *linestart, guint elem, guint base, gboolean reuse_file);
78
79gchar *hal_util_grep_string_elem_from_file (const gchar *directory, const gchar *file,
80					    const gchar *linestart, guint elem, gboolean reuse_file);
81
82gboolean hal_util_set_string_elem_from_file (HalDevice *d, const gchar *key,
83					     const gchar *directory, const gchar *file,
84					     const gchar *linestart, guint elem, gboolean reuse_file);
85
86gboolean hal_util_set_int_elem_from_file (HalDevice *d, const gchar *key,
87					  const gchar *directory, const gchar *file,
88					  const gchar *linestart, guint elem, guint base, gboolean reuse_file);
89
90gboolean hal_util_set_bool_elem_from_file (HalDevice *d, const gchar *key,
91					   const gchar *directory, const gchar *file,
92					   const gchar *linestart, guint elem, const gchar *expected,
93					   gboolean reuse_file);
94
95gchar **hal_util_dup_strv_from_g_slist (GSList *strlist);
96
97typedef void (*HalCalloutsDone) (HalDevice *d, gpointer userdata1, gpointer userdata2);
98
99void hal_util_callout_device_add (HalDevice *d, HalCalloutsDone callback, gpointer userdata1, gpointer userdata2);
100void hal_util_callout_device_remove (HalDevice *d, HalCalloutsDone callback, gpointer userdata1, gpointer userdata2);
101void hal_util_callout_device_preprobe (HalDevice *d, HalCalloutsDone callback, gpointer userdata1, gpointer userdata2);
102
103gchar *hal_util_strdup_valid_utf8 (const char *str);
104
105void hal_util_hexdump (const void *buf, unsigned int size);
106
107gboolean hal_util_is_mounted_by_hald (const char *mount_point);
108
109void
110hal_util_branch_claim (HalDeviceStore *store, HalDevice *root, dbus_bool_t claimed, const char *service, int uid);
111
112#endif /* UTIL_H */
113