| blob | 5c2c797b90147a0e8130b9236220ef6144c0d68c |
1 /*
2 Samba Unix/Linux SMB client library
3 Distributed SMB/CIFS Server Management Utility
4 Copyright (C) 2004,2009 Guenther Deschner (gd@samba.org)
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/>.
18 */
32 /* support itanium as well */
44 };
47 /**
48 * This display-printdriver-functions was borrowed from rpcclient/cmd_spoolss.c.
49 * It is here for debugging purpose and should be removed later on.
50 **/
52 /****************************************************************************
53 Printer info level 3 display function.
54 ****************************************************************************/
57 {
62 }
75 }
81 }
83 static void display_reg_value(const char *subkey, const char *name, struct registry_value *value)
84 {
94 name);
95 }
102 }
119 }
124 }
127 }
131 }
133 }
135 /**
136 * Copies ACLs, DOS-attributes and timestamps from one
137 * file or directory from one connected share to another connected share
138 *
139 * @param c A net_context structure
140 * @param mem_ctx A talloc-context
141 * @param cli_share_src A connected cli_state
142 * @param cli_share_dst A connected cli_state
143 * @param src_file The source file-name
144 * @param dst_file The destination file-name
145 * @param copy_acls Whether to copy acls
146 * @param copy_attrs Whether to copy DOS attributes
147 * @param copy_timestamps Whether to preserve timestamps
148 * @param is_file Whether this file is a file or a dir
149 *
150 * @return Normal NTSTATUS return.
151 **/
160 {
161 NTSTATUS nt_status;
171 /* open file/dir on the originating server */
184 }
187 /* get the security descriptor */
194 }
198 }
202 /* get file attributes */
209 }
210 }
212 /* open the file/dir on the destination server */
221 }
224 /* set timestamps */
230 }
231 }
234 /* set acls */
240 }
241 }
244 /* set attrs */
250 }
251 }
254 /* closing files */
261 }
269 }
274 out:
276 /* cleaning up */
284 }
286 /**
287 * Copy a file or directory from a connected share to another connected share
288 *
289 * @param c A net_context structure
290 * @param mem_ctx A talloc-context
291 * @param cli_share_src A connected cli_state
292 * @param cli_share_dst A connected cli_state
293 * @param src_file The source file-name
294 * @param dst_file The destination file-name
295 * @param copy_acls Whether to copy acls
296 * @param copy_attrs Whether to copy DOS attributes
297 * @param copy_timestamps Whether to preserve timestamps
298 * @param is_file Whether this file is a file or a dir
299 *
300 * @return Normal NTSTATUS return.
301 **/
310 {
326 /* open on the originating server */
331 else
340 }
345 /* open file on the destination server */
354 }
356 /* allocate memory */
359 read_size);
362 }
364 }
378 }
383 /* copying file */
395 }
410 }
413 }
418 /* creating dir */
420 dst_name));
427 }
436 }
437 }
440 /* closing files */
447 }
456 }
457 }
459 /* possibly we have to copy some file-attributes / acls / sd */
469 out:
471 /* cleaning up */
481 }
483 /**
484 * Copy a driverfile from on connected share to another connected share
485 * This silently assumes that a driver-file is picked up from
486 *
487 * \\src_server\print$\{arch}\{version}\file
488 *
489 * and copied to
490 *
491 * \\dst_server\print$\{arch}\file
492 *
493 * to be added via setdriver-calls later.
494 * @param c A net_context structure
495 * @param mem_ctx A talloc-context
496 * @param cli_share_src A cli_state connected to source print$-share
497 * @param cli_share_dst A cli_state connected to destination print$-share
498 * @param file The file-name to be copied
499 * @param short_archi The name of the driver-architecture (short form)
500 *
501 * @return Normal NTSTATUS return.
502 **/
519 }
521 /* scroll through the file until we have the part
522 beyond archi_table.short_archi */
528 }
529 }
533 }
535 /* build source file name */
540 }
542 /* create destination file name */
546 }
549 /* finally copy the file */
552 }
554 /**
555 * Check for existing Architecture directory on a given server
556 *
557 * @param cli_share A cli_state connected to a print$-share
558 * @param short_archi The Architecture for the print-driver
559 *
560 * @return Normal NTSTATUS return.
561 **/
564 {
571 }
574 short_archi));
580 }
587 }
591 out:
594 }
596 /**
597 * Copy a print-driver (level 3) from one connected print$-share to another
598 * connected print$-share
599 *
600 * @param c A net_context structure
601 * @param mem_ctx A talloc-context
602 * @param cli_share_src A cli_state connected to a print$-share
603 * @param cli_share_dst A cli_state connected to a print$-share
604 * @param short_archi The Architecture for the print-driver
605 * @param i1 The DRIVER_INFO_3-struct
606 *
607 * @return Normal NTSTATUS return.
608 **/
616 {
622 }
656 }
657 }
660 }
662 /**
663 * net_spoolss-functions
664 * =====================
665 *
666 * the net_spoolss-functions aim to simplify spoolss-client-functions
667 * required during the migration-process wrt buffer-sizes, returned
668 * error-codes, etc.
669 *
670 * this greatly reduces the complexitiy of the migrate-functions.
671 *
672 **/
681 {
682 WERROR result;
684 /* enum printers */
687 flags,
688 name,
689 level,
691 num_printers,
692 info);
696 }
699 }
707 {
708 WERROR result;
709 fstring printername2;
718 /* open printer */
720 printername2,
721 access_required,
722 hnd);
724 /* be more verbose */
731 }
737 }
743 }
750 {
751 WERROR result;
753 /* getprinter call */
755 hnd,
756 level,
758 info);
762 }
765 }
772 {
774 WERROR result;
775 NTSTATUS status;
784 /* setprinter call */
829 #endif
832 }
835 hnd,
844 }
848 }
851 }
861 {
863 WERROR result;
864 NTSTATUS status;
866 /* setprinterdata call */
868 hnd,
869 value_name,
870 type,
871 data,
872 offered,
878 }
883 }
886 }
894 {
895 WERROR result;
897 /* enumprinterkey call */
903 }
906 }
915 {
916 WERROR result;
918 /* enumprinterdataex call */
920 hnd,
921 keyname,
923 count,
924 info);
929 }
932 }
941 {
943 WERROR result;
944 NTSTATUS status;
946 /* setprinterdataex call */
948 hnd,
949 keyname,
950 name,
959 }
964 }
967 }
975 {
976 WERROR result;
978 /* enumforms call */
980 hnd,
981 level,
983 num_forms,
984 forms);
988 }
991 }
998 {
999 WERROR result;
1001 /* enumprinterdrivers call */
1004 env,
1005 level,
1007 count,
1008 info);
1016 env);
1017 }
1018 }
1021 }
1028 {
1029 WERROR result;
1033 /* getprinterdriver call */
1035 hnd,
1036 env,
1037 level,
1039 version,
1041 info,
1051 }
1053 }
1056 }
1062 {
1064 WERROR result;
1065 NTSTATUS status;
1082 }
1084 /* addprinterdriver call */
1092 }
1093 /* be more verbose */
1097 }
1101 }
1104 }
1106 /**
1107 * abstraction function to get uint32_t num_printers and PRINTER_INFO_CTR ctr
1108 * for a single printer or for all printers depending on argc/argv
1109 **/
1118 {
1121 WERROR werr;
1123 /* no arguments given, enumerate all printers */
1132 }
1134 /* argument given, get a single printer by name */
1136 MAXIMUM_ALLOWED_ACCESS,
1144 }
1149 }
1155 out:
1160 }
1162 /**
1163 * List print-queues (including local printers that are not shared)
1164 *
1165 * All parameters are provided by the run_rpc_command function, except for
1166 * argc, argv which are passed through.
1167 *
1168 * @param c A net_context structure
1169 * @param domain_sid The domain sid aquired from the remote server
1170 * @param cli A cli_state connected to the server.
1171 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1172 * @param argc Standard main() style argc
1173 * @param argv Standard main() style argv. Initial components are already
1174 * stripped
1175 *
1176 * @return Normal NTSTATUS return.
1177 **/
1187 {
1201 /* do some initialization */
1208 }
1209 }
1212 }
1214 /**
1215 * List printer-drivers from a server
1216 *
1217 * All parameters are provided by the run_rpc_command function, except for
1218 * argc, argv which are passed through.
1219 *
1220 * @param c A net_context structure
1221 * @param domain_sid The domain sid aquired from the remote server
1222 * @param cli A cli_state connected to the server.
1223 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1224 * @param argc Standard main() style argc
1225 * @param argv Standard main() style argv. Initial components are already
1226 * stripped
1227 *
1228 * @return Normal NTSTATUS return.
1229 **/
1239 {
1252 /* enum remote drivers */
1258 }
1265 }
1271 /* do something for all drivers for architecture */
1274 }
1275 }
1279 done:
1282 }
1284 /**
1285 * Publish print-queues with args-wrapper
1286 *
1287 * @param cli A cli_state connected to the server.
1288 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1289 * @param argc Standard main() style argc
1290 * @param argv Standard main() style argv. Initial components are already
1291 * stripped
1292 * @param action
1293 *
1294 * @return Normal NTSTATUS return.
1295 **/
1302 {
1314 WERROR result;
1322 /* do some initialization */
1327 }
1329 /* open printer handle */
1334 /* check for existing dst printer */
1338 /* check action and set string */
1353 }
1374 }
1381 }
1384 }
1388 }
1392 done:
1395 }
1398 }
1408 {
1410 }
1420 {
1422 }
1432 {
1434 }
1436 /**
1437 * List print-queues w.r.t. their publishing state
1438 *
1439 * All parameters are provided by the run_rpc_command function, except for
1440 * argc, argv which are passed through.
1441 *
1442 * @param c A net_context structure
1443 * @param domain_sid The domain sid aquired from the remote server
1444 * @param cli A cli_state connected to the server.
1445 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1446 * @param argc Standard main() style argc
1447 * @param argv Standard main() style argv. Initial components are already
1448 * stripped
1449 *
1450 * @return Normal NTSTATUS return.
1451 **/
1461 {
1471 WERROR werr;
1478 /* do some initialization */
1484 }
1486 /* open printer handle */
1491 /* check for existing dst printer */
1497 }
1502 sharename);
1509 sharename);
1513 sharename);
1518 }
1519 }
1523 done:
1526 }
1529 }
1531 /**
1532 * Migrate Printer-ACLs from a source server to the destination server
1533 *
1534 * All parameters are provided by the run_rpc_command function, except for
1535 * argc, argv which are passed through.
1536 *
1537 * @param c A net_context structure
1538 * @param domain_sid The domain sid aquired from the remote server
1539 * @param cli A cli_state connected to the server.
1540 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1541 * @param argc Standard main() style argc
1542 * @param argv Standard main() style argv. Initial components are already
1543 * stripped
1544 *
1545 * @return Normal NTSTATUS return.
1546 **/
1556 {
1558 /* TODO: what now, info2 or info3 ?
1559 convince jerry that we should add clientside setacls level 3 at least
1560 */
1573 WERROR werr;
1577 /* connect destination PI_SPOOLSS */
1582 }
1585 /* enum source printers */
1589 }
1595 }
1597 /* do something for all printers */
1600 /* do some initialization */
1607 }
1609 /* we can reset NT_STATUS here because we do not
1610 get any real NT_STATUS-codes anymore from now on */
1616 /* according to msdn you have specify these access-rights
1617 to see the security descriptor
1618 - READ_CONTROL (DACL)
1619 - ACCESS_SYSTEM_SECURITY (SACL)
1620 */
1622 /* open src printer handle */
1627 /* open dst printer handle */
1632 /* check for existing dst printer */
1636 /* check for existing src printer */
1640 /* Copy Security Descriptor */
1642 /* copy secdesc (info level 2) */
1655 /* close printer handles here */
1658 }
1662 }
1664 }
1668 done:
1672 }
1676 }
1680 }
1682 }
1684 /**
1685 * Migrate printer-forms from a src server to the dst server
1686 *
1687 * All parameters are provided by the run_rpc_command function, except for
1688 * argc, argv which are passed through.
1689 *
1690 * @param c A net_context structure
1691 * @param domain_sid The domain sid aquired from the remote server
1692 * @param cli A cli_state connected to the server.
1693 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1694 * @param argc Standard main() style argc
1695 * @param argv Standard main() style argv. Initial components are already
1696 * stripped
1697 *
1698 * @return Normal NTSTATUS return.
1699 **/
1709 {
1712 WERROR result;
1729 /* connect destination PI_SPOOLSS */
1734 }
1737 /* enum src printers */
1741 }
1747 }
1749 /* do something for all printers */
1752 /* do some initialization */
1759 }
1760 /* we can reset NT_STATUS here because we do not
1761 get any real NT_STATUS-codes anymore from now on */
1768 /* open src printer handle */
1773 /* open dst printer handle */
1778 /* check for existing dst printer */
1782 /* finally migrate forms */
1792 NTSTATUS status;
1794 /* only migrate FORM_PRINTER types, according to jerry
1795 FORM_BUILTIN-types are hard-coded in samba */
1808 /* FIXME: there might be something wrong with samba's
1809 builtin-forms */
1813 info,
1819 }
1824 }
1828 }
1831 /* close printer handles here */
1834 }
1838 }
1839 }
1843 done:
1847 }
1851 }
1855 }
1857 }
1859 /**
1860 * Migrate printer-drivers from a src server to the dst server
1861 *
1862 * All parameters are provided by the run_rpc_command function, except for
1863 * argc, argv which are passed through.
1864 *
1865 * @param c A net_context structure
1866 * @param domain_sid The domain sid aquired from the remote server
1867 * @param cli A cli_state connected to the server.
1868 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1869 * @param argc Standard main() style argc
1870 * @param argv Standard main() style argv. Initial components are already
1871 * stripped
1872 *
1873 * @return Normal NTSTATUS return.
1874 **/
1884 {
1904 WERROR werr;
1912 }
1915 /* open print$-share on the src server */
1926 /* open print$-share on the dst server */
1937 /* enum src printers */
1941 }
1947 }
1950 /* do something for all printers */
1953 /* do some initialization */
1960 }
1962 /* we can reset NT_STATUS here because we do not
1963 get any real NT_STATUS-codes anymore from now on */
1969 /* open dst printer handle */
1974 /* check for existing dst printer */
1979 /* open src printer handle */
1981 MAXIMUM_ALLOWED_ACCESS,
1986 /* in a first step call getdriver for each shared printer (per arch)
1987 to get a list of all files that have to be copied */
1991 /* getdriver src */
2002 /* check arch dir */
2008 /* copy driver-files */
2016 /* adddriver dst */
2020 }
2025 }
2029 printername));
2031 }
2033 /* setdriver dst */
2039 }
2044 /* close dst */
2047 }
2049 /* close src */
2052 }
2053 }
2057 done:
2061 }
2063 /* close src */
2066 }
2070 }
2080 }
2082 /**
2083 * Migrate printer-queues from a src to the dst server
2084 * (requires a working "addprinter command" to be installed for the local smbd)
2085 *
2086 * All parameters are provided by the run_rpc_command function, except for
2087 * argc, argv which are passed through.
2088 *
2089 * @param c A net_context structure
2090 * @param domain_sid The domain sid aquired from the remote server
2091 * @param cli A cli_state connected to the server.
2092 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2093 * @param argc Standard main() style argc
2094 * @param argv Standard main() style argv. Initial components are already
2095 * stripped
2096 *
2097 * @return Normal NTSTATUS return.
2098 **/
2108 {
2110 WERROR result;
2126 /* connect destination PI_SPOOLSS */
2131 }
2134 /* enum printers */
2138 }
2144 }
2146 /* do something for all printers */
2151 /* do some initialization */
2158 }
2159 /* we can reset NT_STATUS here because we do not
2160 get any real NT_STATUS-codes anymore from now on */
2166 /* open dst printer handle */
2171 }
2173 /* check for existing dst printer */
2178 /* close printer handle here - dst only, not got src yet. */
2181 }
2183 }
2185 /* now get again src printer ctr via getprinter,
2186 we first need a handle for that */
2188 /* open src printer handle */
2193 /* getprinter on the src server */
2197 /* copy each src printer to a dst printer 1:1,
2198 maybe some values have to be changed though */
2206 mem_ctx,
2211 printername);
2214 printername);
2217 printername);
2219 }
2221 /* close printer handles here */
2224 }
2228 }
2229 }
2233 done:
2236 }
2240 }
2244 }
2246 }
2248 /**
2249 * Migrate Printer-Settings from a src server to the dst server
2250 * (for this to work, printers and drivers already have to be migrated earlier)
2251 *
2252 * All parameters are provided by the run_rpc_command function, except for
2253 * argc, argv which are passed through.
2254 *
2255 * @param c A net_context structure
2256 * @param domain_sid The domain sid aquired from the remote server
2257 * @param cli A cli_state connected to the server.
2258 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2259 * @param argc Standard main() style argc
2260 * @param argv Standard main() style argv. Initial components are already
2261 * stripped
2262 *
2263 * @return Normal NTSTATUS return.
2264 **/
2274 {
2277 /* FIXME: Here the nightmare begins */
2279 WERROR result;
2296 /* FIXME GD */
2301 /* connect destination PI_SPOOLSS */
2306 }
2309 /* enum src printers */
2313 }
2319 }
2322 /* needed for dns-strings in regkeys */
2327 }
2329 /* do something for all printers */
2337 /* do some initialization */
2344 }
2345 /* we can reset NT_STATUS here because we do not
2346 get any real NT_STATUS-codes anymore from now on */
2353 /* open src printer handle */
2358 /* open dst printer handle */
2363 /* check for existing dst printer */
2369 /* STEP 1: COPY DEVICE-MODE and other
2370 PRINTER_INFO_2-attributes
2371 */
2375 /* why is the port always disconnected when the printer
2376 is correctly installed (incl. driver ???) */
2379 /* check if printer is published */
2382 /* check for existing dst printer */
2388 /* ignore false from setprinter due to WERR_IO_PENDING */
2392 }
2396 /* copy devmode (info level 2) */
2399 /* do not copy security descriptor (we have another
2400 * command for that) */
2403 #if 0
2410 }
2411 #endif
2417 }
2419 /* STEP 2: COPY REGISTRY VALUES */
2421 /* please keep in mind that samba parse_spools gives horribly
2422 crippled results when used to rpccli_spoolss_enumprinterdataex
2423 a win2k3-server. (Bugzilla #1851)
2424 FIXME: IIRC I've seen it too on a win2k-server
2425 */
2437 /* enumerate data on src handle */
2445 /* loop for all printerdata of "PrinterDriverData" */
2452 /* loop for all reg_keys */
2455 /* display_value */
2464 }
2466 /* set_value */
2474 }
2475 }
2477 /* STEP 3: COPY SUBKEY VALUES */
2479 /* here we need to enum all printer_keys and then work
2480 on the result with enum_printer_key_ex. nt4 does not
2481 respond to enumprinterkey, win2k does, so continue
2482 in case of an error */
2487 }
2490 /* work on a list of printer keys
2491 each key has to be enumerated to get all required
2492 information. information is then set via setprinterdataex-calls */
2503 /* enumerate all src subkeys */
2508 }
2516 /* although samba replies with sane data in most cases we
2517 should try to avoid writing wrong registry data */
2520 /* although windows uses a multi-sz, we use a sz */
2522 }
2528 }
2531 }
2534 #if 0
2535 /* FIXME: should we really do that ??? */
2539 }
2542 #endif
2543 }
2546 }
2549 }
2553 }
2557 }
2559 /* here we have to set all subkeys on the dst server */
2562 {
2564 }
2569 }
2570 }
2574 /* close printer handles here */
2577 }
2581 }
2582 }
2586 done:
2589 }
2593 }
2597 }
2599 }