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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
// SPDX-License-Identifier: BSD-2-Clause
// Copyright The Music Player Daemon Project
/*! \file
* \brief MPD client library
*
* Do not include this header directly. Use mpd/client.h instead.
*/
#ifndef MPD_MOUNT_H
#define MPD_MOUNT_H
#include "compiler.h"
#include <stdbool.h>
struct mpd_connection;
struct mpd_pair;
/**
* \struct mpd_mount
*
* This type represents a mount point on the MPD server.
*/
struct mpd_mount;
#ifdef __cplusplus
extern "C" {
#endif
/**
* Begins parsing a new #mpd_mount.
*
* @param pair the first pair in this mount point
* @return the new #mpd_mount object, or NULL on error (out of
* memory, or wrong pair name)
*
* @since libmpdclient 2.16
*/
mpd_malloc
struct mpd_mount *
mpd_mount_begin(const struct mpd_pair *pair);
/**
* Parses the pair, adding its information to the specified
* #mpd_mount object.
*
* @return true if the pair was parsed and added to the mount (or if
* the pair was not understood and ignored), false if this pair is the
* beginning of the next mount
*
* @since libmpdclient 2.16
*/
bool
mpd_mount_feed(struct mpd_mount *mnt, const struct mpd_pair *pair);
/**
* Frees a mpd_mount object returned from mpd_recv_mount() or mpd_mount_begin().
*
* @since libmpdclient 2.16
*/
void
mpd_mount_free(struct mpd_mount *mount);
/**
* @return the mount point URI of the specified #mpd_mount object
*
* @since libmpdclient 2.16
*/
mpd_pure
const char *
mpd_mount_get_uri(const struct mpd_mount *mnt);
/**
* @return the mounted storage URI of the specified #mpd_mount object;
* may be NULL if MPD did not reveal it
*
* @since libmpdclient 2.16
*/
mpd_pure
const char *
mpd_mount_get_storage(const struct mpd_mount *mnt);
/**
* Sends the "listmounts" command to MPD. Call mpd_recv_mount() to
* read the response.
*
* @param connection a valid and connected mpd_connection.
* @return true on success
*
* @since libmpdclient 2.16, MPD 0.19
*/
bool
mpd_send_list_mounts(struct mpd_connection *connection);
/**
* Reads the next mpd_mount from the MPD response. Free the return
* value with mpd_mount_free().
*
* @return a mpd_mount object on success, NULL on error or
* end-of-response
*
* @since libmpdclient 2.16, MPD 0.19
*/
mpd_malloc
struct mpd_mount *
mpd_recv_mount(struct mpd_connection *connection);
/**
* Sends the "mount" command to MPD.
*
* @param connection a valid and connected mpd_connection.
* @param uri the mount point URI
* @param storage the mounted storage URI
* @return true on success
*
* @since libmpdclient 2.16, MPD 0.19
*/
bool
mpd_send_mount(struct mpd_connection *connection,
const char *uri, const char *storage);
/**
* Shortcut for mpd_send_mount() and mpd_response_finish().
*
* @param connection A valid and connected mpd_connection.
* @param uri the mount point URI
* @param storage the mounted storage URI
* @return true on success
*
* @since libmpdclient 2.16, MPD 0.19
*/
bool
mpd_run_mount(struct mpd_connection *connection,
const char *uri, const char *storage);
/**
* Sends the "unmount" command to MPD.
*
* @param connection a valid and connected mpd_connection.
* @param uri the mount point URI
* @return true on success
*
* @since libmpdclient 2.16, MPD 0.19
*/
bool
mpd_send_unmount(struct mpd_connection *connection, const char *uri);
/**
* Shortcut for mpd_send_unmount() and mpd_response_finish().
*
* @param connection A valid and connected mpd_connection.
* @param uri the mount point URI
* @return true on success
*
* @since libmpdclient 2.16, MPD 0.19
*/
bool
mpd_run_unmount(struct mpd_connection *connection, const char *uri);
#ifdef __cplusplus
}
#endif
#endif
|
