lib/param: Rename "socket address" to "nbt client socket address" to clarify role
[kai/samba.git] / source3 / include / nt_printing.h
1 /*
2    Unix SMB/Netbios implementation.
3    Version 1.9.
4    SMB parameters and setup
5    Copyright (C) Andrew Tridgell              1992-2000,
6    Copyright (C) Jean Francois Micouleau      1998-2000.
7
8    This program is free software; you can redistribute it and/or modify
9    it under the terms of the GNU General Public License as published by
10    the Free Software Foundation; either version 3 of the License, or
11    (at your option) any later version.
12
13    This program is distributed in the hope that it will be useful,
14    but WITHOUT ANY WARRANTY; without even the implied warranty of
15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16    GNU General Public License for more details.
17
18    You should have received a copy of the GNU General Public License
19    along with this program.  If not, see <http://www.gnu.org/licenses/>.
20 */
21
22 #ifndef NT_PRINTING_H_
23 #define NT_PRINTING_H_
24
25 #include "client.h"
26 #include "../librpc/gen_ndr/spoolss.h"
27
28 #ifndef SAMBA_PRINTER_PORT_NAME
29 #define SAMBA_PRINTER_PORT_NAME "Samba Printer Port"
30 #endif
31
32 /* DOS header format */
33 #define DOS_HEADER_SIZE                 64
34 #define DOS_HEADER_MAGIC_OFFSET         0
35 #define DOS_HEADER_MAGIC                0x5A4D
36 #define DOS_HEADER_LFANEW_OFFSET        60
37
38 /* New Executable format (Win or OS/2 1.x segmented) */
39 #define NE_HEADER_SIZE                  64
40 #define NE_HEADER_SIGNATURE_OFFSET      0
41 #define NE_HEADER_SIGNATURE             0x454E
42 #define NE_HEADER_TARGET_OS_OFFSET      54
43 #define NE_HEADER_TARGOS_WIN            0x02
44 #define NE_HEADER_MINOR_VER_OFFSET      62
45 #define NE_HEADER_MAJOR_VER_OFFSET      63
46
47 /* Portable Executable format */
48 #define PE_HEADER_SIZE                  24
49 #define PE_HEADER_SIGNATURE_OFFSET      0
50 #define PE_HEADER_SIGNATURE             0x00004550
51 #define PE_HEADER_MACHINE_OFFSET        4
52 #define PE_HEADER_MACHINE_I386          0x14c
53 #define PE_HEADER_NUMBER_OF_SECTIONS    6
54 #define PE_HEADER_OPTIONAL_HEADER_SIZE  20
55 #define PE_HEADER_SECT_HEADER_SIZE      40
56 #define PE_HEADER_SECT_NAME_OFFSET      0
57 #define PE_HEADER_SECT_SIZE_DATA_OFFSET 16
58 #define PE_HEADER_SECT_PTR_DATA_OFFSET  20
59
60 /* Microsoft file version format */
61 #define VS_SIGNATURE                    "VS_VERSION_INFO"
62 #define VS_MAGIC_VALUE                  0xfeef04bd
63 #define VS_MAJOR_OFFSET                                 8
64 #define VS_MINOR_OFFSET                                 12
65 #define VS_VERSION_INFO_UNICODE_SIZE    (sizeof(VS_SIGNATURE)*2+4+VS_MINOR_OFFSET+4) /* not true size! */
66 #define VS_VERSION_INFO_SIZE            (sizeof(VS_SIGNATURE)+4+VS_MINOR_OFFSET+4)   /* not true size! */
67 #define VS_NE_BUF_SIZE                  4096  /* Must be > 2*VS_VERSION_INFO_SIZE */
68
69 /* Notify spoolss clients that something has changed.  The
70    notification data is either stored in two uint32 values or a
71    variable length array. */
72
73 #define SPOOLSS_NOTIFY_MSG_UNIX_JOBID 0x0001    /* Job id is unix  */
74
75 typedef struct spoolss_notify_msg {
76         fstring printer;        /* Name of printer notified */
77         uint32 type;            /* Printer or job notify */
78         uint32 field;           /* Notify field changed */
79         uint32 id;              /* Job id */
80         uint32 len;             /* Length of data, 0 for two uint32 value */
81         uint32 flags;
82         union {
83                 uint32 value[2];
84                 char *data;
85         } notify;
86 } SPOOLSS_NOTIFY_MSG;
87
88 typedef struct {
89         fstring                 printername;
90         uint32                  num_msgs;
91         SPOOLSS_NOTIFY_MSG      *msgs;
92 } SPOOLSS_NOTIFY_MSG_GROUP;
93
94 typedef struct {
95         TALLOC_CTX                      *ctx;
96         uint32                          num_groups;
97         SPOOLSS_NOTIFY_MSG_GROUP        *msg_groups;
98 } SPOOLSS_NOTIFY_MSG_CTR;
99
100 #define SPLHND_PRINTER          1
101 #define SPLHND_SERVER           2
102 #define SPLHND_PORTMON_TCP      3
103 #define SPLHND_PORTMON_LOCAL    4
104
105 /*
106  * The printer attributes.
107  * I #defined all of them (grabbed form MSDN)
108  * I'm only using:
109  * ( SHARED | NETWORK | RAW_ONLY )
110  * RAW_ONLY _MUST_ be present otherwise NT will send an EMF file
111  */
112
113 #define PRINTER_ATTRIBUTE_SAMBA                 (PRINTER_ATTRIBUTE_RAW_ONLY|\
114                                                  PRINTER_ATTRIBUTE_SHARED|\
115                                                  PRINTER_ATTRIBUTE_LOCAL)
116 #define PRINTER_ATTRIBUTE_NOT_SAMBA             (PRINTER_ATTRIBUTE_NETWORK)
117
118 #define DRIVER_ANY_VERSION              0xffffffff
119 #define DRIVER_MAX_VERSION              4
120
121 struct print_architecture_table_node {
122         const char      *long_archi;
123         const char      *short_archi;
124         int     version;
125 };
126
127 bool nt_printing_init(struct messaging_context *msg_ctx);
128
129 const char *get_short_archi(const char *long_archi);
130
131 bool print_access_check(const struct auth_session_info *server_info,
132                         struct messaging_context *msg_ctx, int snum,
133                         int access_type);
134
135 WERROR nt_printer_publish(TALLOC_CTX *mem_ctx,
136                           const struct auth_session_info *server_info,
137                           struct messaging_context *msg_ctx,
138                           struct spoolss_PrinterInfo2 *pinfo2,
139                           int action);
140
141 bool is_printer_published(TALLOC_CTX *mem_ctx,
142                           const struct auth_session_info *server_info,
143                           struct messaging_context *msg_ctx,
144                           const char *servername,
145                           const char *printer,
146                           struct GUID *guid,
147                           struct spoolss_PrinterInfo2 **info2);
148
149 WERROR check_published_printers(struct messaging_context *msg_ctx);
150
151 struct dcerpc_binding_handle;
152
153 bool printer_driver_in_use(TALLOC_CTX *mem_ctx,
154                            struct dcerpc_binding_handle *b,
155                            const struct spoolss_DriverInfo8 *r);
156 bool printer_driver_files_in_use(TALLOC_CTX *mem_ctx,
157                                  struct dcerpc_binding_handle *b,
158                                  struct spoolss_DriverInfo8 *r);
159 bool delete_driver_files(const struct auth_session_info *server_info,
160                          const struct spoolss_DriverInfo8 *r);
161
162 WERROR move_driver_to_download_area(struct auth_session_info *session_info,
163                                     struct spoolss_AddDriverInfoCtr *r);
164
165 WERROR clean_up_driver_struct(TALLOC_CTX *mem_ctx,
166                               struct auth_session_info *session_info,
167                               struct spoolss_AddDriverInfoCtr *r);
168
169 void map_printer_permissions(struct security_descriptor *sd);
170
171 void map_job_permissions(struct security_descriptor *sd);
172
173 bool print_time_access_check(const struct auth_session_info *server_info,
174                              struct messaging_context *msg_ctx,
175                              const char *servicename);
176
177 void nt_printer_remove(TALLOC_CTX *mem_ctx,
178                         const struct auth_session_info *server_info,
179                         struct messaging_context *msg_ctx,
180                         const char *printer);
181 void nt_printer_add(TALLOC_CTX *mem_ctx,
182                     const struct auth_session_info *server_info,
183                     struct messaging_context *msg_ctx,
184                     const char *printer);
185
186 #endif /* NT_PRINTING_H_ */