s3-docs: Typos in rpcclient man page
[Samba/gebeck_regimport.git] / source3 / printing / printer_list.c
blobd36a746e45219a3302b412be076c5c7595af12f5
1 /*
2 Unix SMB/CIFS implementation.
3 Share Database of available printers.
4 Copyright (C) Simo Sorce 2010
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>.
20 #include "includes.h"
21 #include "dbwrap.h"
22 #include "printer_list.h"
24 #define PL_DB_NAME() lock_path("printer_list.tdb")
25 #define PL_KEY_PREFIX "PRINTERLIST/PRN/"
26 #define PL_KEY_FORMAT PL_KEY_PREFIX"%s"
27 #define PL_TIMESTAMP_KEY "PRINTERLIST/GLOBAL/LAST_REFRESH"
28 #define PL_DATA_FORMAT "ddPP"
29 #define PL_TSTAMP_FORMAT "dd"
31 static struct db_context *get_printer_list_db(void)
33 static struct db_context *db;
35 if (db != NULL) {
36 return db;
38 db = db_open(NULL, PL_DB_NAME(), 0,
39 TDB_DEFAULT|TDB_CLEAR_IF_FIRST|TDB_INCOMPATIBLE_HASH,
40 O_RDWR|O_CREAT, 0644);
41 return db;
44 bool printer_list_parent_init(void)
46 struct db_context *db;
49 * Open the tdb in the parent process (smbd) so that our
50 * CLEAR_IF_FIRST optimization in tdb_reopen_all can properly
51 * work.
54 db = get_printer_list_db();
55 if (db == NULL) {
56 DEBUG(1, ("could not open Printer List Database: %s\n",
57 strerror(errno)));
58 return false;
60 return true;
63 NTSTATUS printer_list_get_printer(TALLOC_CTX *mem_ctx,
64 const char *name,
65 const char **comment,
66 time_t *last_refresh)
68 struct db_context *db;
69 char *key;
70 TDB_DATA data;
71 uint32_t time_h, time_l;
72 char *nstr = NULL;
73 char *cstr = NULL;
74 NTSTATUS status;
75 int ret;
77 db = get_printer_list_db();
78 if (db == NULL) {
79 return NT_STATUS_INTERNAL_DB_CORRUPTION;
82 key = talloc_asprintf(mem_ctx, PL_KEY_FORMAT, name);
83 if (!key) {
84 DEBUG(0, ("Failed to allocate key name!\n"));
85 return NT_STATUS_NO_MEMORY;
88 data = dbwrap_fetch_bystring_upper(db, key, key);
89 if (data.dptr == NULL) {
90 DEBUG(1, ("Failed to fetch record!\n"));
91 status = NT_STATUS_NOT_FOUND;
92 goto done;
95 ret = tdb_unpack(data.dptr, data.dsize,
96 PL_DATA_FORMAT,
97 &time_h, &time_l, &nstr, &cstr);
98 if (ret == -1) {
99 DEBUG(1, ("Failed to un pack printer data"));
100 status = NT_STATUS_INTERNAL_DB_CORRUPTION;
101 goto done;
104 if (last_refresh) {
105 *last_refresh = (time_t)(((uint64_t)time_h << 32) + time_l);
108 if (comment) {
109 *comment = talloc_strdup(mem_ctx, cstr);
110 if (!*comment) {
111 DEBUG(1, ("Failed to strdup comment!\n"));
112 status = NT_STATUS_NO_MEMORY;
113 goto done;
117 status = NT_STATUS_OK;
119 done:
120 SAFE_FREE(nstr);
121 SAFE_FREE(cstr);
122 TALLOC_FREE(key);
123 return status;
126 NTSTATUS printer_list_set_printer(TALLOC_CTX *mem_ctx,
127 const char *name,
128 const char *comment,
129 time_t last_refresh)
131 struct db_context *db;
132 char *key;
133 TDB_DATA data;
134 uint64_t time_64;
135 uint32_t time_h, time_l;
136 const char *str = NULL;
137 NTSTATUS status;
138 int len;
140 db = get_printer_list_db();
141 if (db == NULL) {
142 return NT_STATUS_INTERNAL_DB_CORRUPTION;
145 key = talloc_asprintf(mem_ctx, PL_KEY_FORMAT, name);
146 if (!key) {
147 DEBUG(0, ("Failed to allocate key name!\n"));
148 return NT_STATUS_NO_MEMORY;
151 if (comment) {
152 str = comment;
153 } else {
154 str = "";
157 time_64 = last_refresh;
158 time_l = time_64 & 0xFFFFFFFFL;
159 time_h = time_64 >> 32;
161 len = tdb_pack(NULL, 0, PL_DATA_FORMAT, time_h, time_l, name, str);
163 data.dptr = talloc_array(key, uint8_t, len);
164 if (!data.dptr) {
165 DEBUG(0, ("Failed to allocate tdb data buffer!\n"));
166 status = NT_STATUS_NO_MEMORY;
167 goto done;
169 data.dsize = len;
171 len = tdb_pack(data.dptr, data.dsize,
172 PL_DATA_FORMAT, time_h, time_l, name, str);
174 status = dbwrap_store_bystring_upper(db, key, data, TDB_REPLACE);
176 done:
177 TALLOC_FREE(key);
178 return status;
181 NTSTATUS printer_list_get_last_refresh(time_t *last_refresh)
183 struct db_context *db;
184 TDB_DATA data;
185 uint32_t time_h, time_l;
186 NTSTATUS status;
187 int ret;
189 db = get_printer_list_db();
190 if (db == NULL) {
191 return NT_STATUS_INTERNAL_DB_CORRUPTION;
194 ZERO_STRUCT(data);
196 data = dbwrap_fetch_bystring(db, talloc_tos(), PL_TIMESTAMP_KEY);
197 if (data.dptr == NULL) {
198 DEBUG(1, ("Failed to fetch record!\n"));
199 status = NT_STATUS_NOT_FOUND;
200 goto done;
203 ret = tdb_unpack(data.dptr, data.dsize,
204 PL_TSTAMP_FORMAT, &time_h, &time_l);
205 if (ret == -1) {
206 DEBUG(1, ("Failed to un pack printer data"));
207 status = NT_STATUS_INTERNAL_DB_CORRUPTION;
208 goto done;
211 *last_refresh = (time_t)(((uint64_t)time_h << 32) + time_l);
212 status = NT_STATUS_OK;
214 done:
215 return status;
218 NTSTATUS printer_list_mark_reload(void)
220 struct db_context *db;
221 TDB_DATA data;
222 uint32_t time_h, time_l;
223 time_t now = time_mono(NULL);
224 NTSTATUS status;
225 int len;
227 db = get_printer_list_db();
228 if (db == NULL) {
229 return NT_STATUS_INTERNAL_DB_CORRUPTION;
232 time_l = ((uint64_t)now) & 0xFFFFFFFFL;
233 time_h = ((uint64_t)now) >> 32;
235 len = tdb_pack(NULL, 0, PL_TSTAMP_FORMAT, time_h, time_l);
237 data.dptr = talloc_array(talloc_tos(), uint8_t, len);
238 if (!data.dptr) {
239 DEBUG(0, ("Failed to allocate tdb data buffer!\n"));
240 status = NT_STATUS_NO_MEMORY;
241 goto done;
243 data.dsize = len;
245 len = tdb_pack(data.dptr, data.dsize,
246 PL_TSTAMP_FORMAT, time_h, time_l);
248 status = dbwrap_store_bystring(db, PL_TIMESTAMP_KEY,
249 data, TDB_REPLACE);
251 done:
252 TALLOC_FREE(data.dptr);
253 return status;
256 typedef int (printer_list_trv_fn_t)(struct db_record *, void *);
258 static NTSTATUS printer_list_traverse(printer_list_trv_fn_t *fn,
259 void *private_data)
261 struct db_context *db;
262 int ret;
264 db = get_printer_list_db();
265 if (db == NULL) {
266 return NT_STATUS_INTERNAL_DB_CORRUPTION;
269 ret = db->traverse(db, fn, private_data);
270 if (ret < 0) {
271 return NT_STATUS_UNSUCCESSFUL;
274 return NT_STATUS_OK;
277 struct printer_list_clean_state {
278 time_t last_refresh;
279 NTSTATUS status;
282 static int printer_list_clean_fn(struct db_record *rec, void *private_data)
284 struct printer_list_clean_state *state =
285 (struct printer_list_clean_state *)private_data;
286 uint32_t time_h, time_l;
287 time_t refresh;
288 char *name;
289 char *comment;
290 int ret;
292 /* skip anything that does not contain PL_DATA_FORMAT data */
293 if (strncmp((char *)rec->key.dptr,
294 PL_KEY_PREFIX, sizeof(PL_KEY_PREFIX)-1)) {
295 return 0;
298 ret = tdb_unpack(rec->value.dptr, rec->value.dsize,
299 PL_DATA_FORMAT, &time_h, &time_l, &name, &comment);
300 if (ret == -1) {
301 DEBUG(1, ("Failed to un pack printer data"));
302 state->status = NT_STATUS_INTERNAL_DB_CORRUPTION;
303 return -1;
306 SAFE_FREE(name);
307 SAFE_FREE(comment);
309 refresh = (time_t)(((uint64_t)time_h << 32) + time_l);
311 if (refresh < state->last_refresh) {
312 state->status = rec->delete_rec(rec);
313 if (!NT_STATUS_IS_OK(state->status)) {
314 return -1;
318 return 0;
321 NTSTATUS printer_list_clean_old(void)
323 struct printer_list_clean_state state;
324 NTSTATUS status;
326 status = printer_list_get_last_refresh(&state.last_refresh);
327 if (!NT_STATUS_IS_OK(status)) {
328 return status;
331 state.status = NT_STATUS_OK;
333 status = printer_list_traverse(printer_list_clean_fn, &state);
334 if (NT_STATUS_EQUAL(status, NT_STATUS_UNSUCCESSFUL) &&
335 !NT_STATUS_IS_OK(state.status)) {
336 status = state.status;
339 return status;
342 struct printer_list_exec_state {
343 void (*fn)(const char *, const char *, void *);
344 void *private_data;
345 NTSTATUS status;
348 static int printer_list_exec_fn(struct db_record *rec, void *private_data)
350 struct printer_list_exec_state *state =
351 (struct printer_list_exec_state *)private_data;
352 uint32_t time_h, time_l;
353 char *name;
354 char *comment;
355 int ret;
357 /* always skip PL_TIMESTAMP_KEY key */
358 if (strequal((const char *)rec->key.dptr, PL_TIMESTAMP_KEY)) {
359 return 0;
362 ret = tdb_unpack(rec->value.dptr, rec->value.dsize,
363 PL_DATA_FORMAT, &time_h, &time_l, &name, &comment);
364 if (ret == -1) {
365 DEBUG(1, ("Failed to un pack printer data"));
366 state->status = NT_STATUS_INTERNAL_DB_CORRUPTION;
367 return -1;
370 state->fn(name, comment, state->private_data);
372 SAFE_FREE(name);
373 SAFE_FREE(comment);
374 return 0;
377 NTSTATUS printer_list_run_fn(void (*fn)(const char *, const char *, void *),
378 void *private_data)
380 struct printer_list_exec_state state;
381 NTSTATUS status;
383 state.fn = fn;
384 state.private_data = private_data;
385 state.status = NT_STATUS_OK;
387 status = printer_list_traverse(printer_list_exec_fn, &state);
388 if (NT_STATUS_EQUAL(status, NT_STATUS_UNSUCCESSFUL) &&
389 !NT_STATUS_IS_OK(state.status)) {
390 status = state.status;
393 return status;