s3:docs: remove documentation of "idmap read only" which was removed.
[Samba.git] / source3 / libsmb / cliprint.c
blob10d1759de82a9ad7757a810c92d31ab0c3b8b8ea
1 /*
2 Unix SMB/CIFS implementation.
3 client print routines
4 Copyright (C) Andrew Tridgell 1994-1998
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 "libsmb/clirap.h"
23 /*****************************************************************************
24 Convert a character pointer in a cli_call_api() response to a form we can use.
25 This function contains code to prevent core dumps if the server returns
26 invalid data.
27 *****************************************************************************/
28 static const char *fix_char_ptr(unsigned int datap, unsigned int converter,
29 char *rdata, int rdrcnt)
31 unsigned int offset;
33 if (datap == 0) {
34 /* turn NULL pointers into zero length strings */
35 return "";
38 offset = datap - converter;
40 if (offset >= rdrcnt) {
41 DEBUG(1,("bad char ptr: datap=%u, converter=%u rdrcnt=%d>",
42 datap, converter, rdrcnt));
43 return "<ERROR>";
45 return &rdata[offset];
48 /****************************************************************************
49 call fn() on each entry in a print queue
50 ****************************************************************************/
52 int cli_print_queue(struct cli_state *cli,
53 void (*fn)(struct print_job_info *))
55 char *rparam = NULL;
56 char *rdata = NULL;
57 char *p;
58 unsigned int rdrcnt, rprcnt;
59 char param[1024];
60 int result_code=0;
61 int i = -1;
63 memset(param,'\0',sizeof(param));
65 p = param;
66 SSVAL(p,0,76); /* API function number 76 (DosPrintJobEnum) */
67 p += 2;
68 safe_strcpy_base(p,"zWrLeh", param, sizeof(param)); /* parameter description? */
69 p = skip_string(param,sizeof(param),p);
70 safe_strcpy_base(p,"WWzWWDDzz", param, sizeof(param)); /* returned data format */
71 p = skip_string(param,sizeof(param),p);
72 safe_strcpy_base(p,cli->share, param, sizeof(param)); /* name of queue */
73 p = skip_string(param,sizeof(param),p);
74 SSVAL(p,0,2); /* API function level 2, PRJINFO_2 data structure */
75 SSVAL(p,2,1000); /* size of bytes of returned data buffer */
76 p += 4;
77 safe_strcpy_base(p,"", param,sizeof(param)); /* subformat */
78 p = skip_string(param,sizeof(param),p);
80 DEBUG(4,("doing cli_print_queue for %s\n", cli->share));
82 if (cli_api(cli,
83 param, PTR_DIFF(p,param), 1024, /* Param, length, maxlen */
84 NULL, 0, CLI_BUFFER_SIZE, /* data, length, maxlen */
85 &rparam, &rprcnt, /* return params, length */
86 &rdata, &rdrcnt)) { /* return data, length */
87 int converter;
88 result_code = SVAL(rparam,0);
89 converter = SVAL(rparam,2); /* conversion factor */
91 if (result_code == 0) {
92 struct print_job_info job;
94 p = rdata;
96 for (i = 0; i < SVAL(rparam,4); ++i) {
97 job.id = SVAL(p,0);
98 job.priority = SVAL(p,2);
99 fstrcpy(job.user,
100 fix_char_ptr(SVAL(p,4), converter,
101 rdata, rdrcnt));
102 job.t = make_unix_date3(
103 p + 12, cli->serverzone);
104 job.size = IVAL(p,16);
105 fstrcpy(job.name,fix_char_ptr(SVAL(p,24),
106 converter,
107 rdata, rdrcnt));
108 fn(&job);
109 p += 28;
114 /* If any parameters or data were returned, free the storage. */
115 SAFE_FREE(rparam);
116 SAFE_FREE(rdata);
118 return i;
121 /****************************************************************************
122 cancel a print job
123 ****************************************************************************/
125 int cli_printjob_del(struct cli_state *cli, int job)
127 char *rparam = NULL;
128 char *rdata = NULL;
129 char *p;
130 unsigned int rdrcnt,rprcnt;
131 int ret = -1;
132 char param[1024];
134 memset(param,'\0',sizeof(param));
136 p = param;
137 SSVAL(p,0,81); /* DosPrintJobDel() */
138 p += 2;
139 safe_strcpy_base(p,"W", param,sizeof(param));
140 p = skip_string(param,sizeof(param),p);
141 safe_strcpy_base(p,"", param,sizeof(param));
142 p = skip_string(param,sizeof(param),p);
143 SSVAL(p,0,job);
144 p += 2;
146 if (cli_api(cli,
147 param, PTR_DIFF(p,param), 1024, /* Param, length, maxlen */
148 NULL, 0, CLI_BUFFER_SIZE, /* data, length, maxlen */
149 &rparam, &rprcnt, /* return params, length */
150 &rdata, &rdrcnt)) { /* return data, length */
151 ret = SVAL(rparam,0);
154 SAFE_FREE(rparam);
155 SAFE_FREE(rdata);
157 return ret;