| blob | 272e0c9dfa1f5008051317f1dd60bf53718b421c |
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 }
84 {
86 DATA_BLOB blob;
99 }
101 text);
118 }
123 }
126 }
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 }
376 }
381 /* copying file */
384 read_size);
396 }
399 }
404 /* creating dir */
406 dst_name));
413 }
422 }
423 }
426 /* closing files */
433 }
442 }
443 }
445 /* possibly we have to copy some file-attributes / acls / sd */
455 out:
457 /* cleaning up */
467 }
469 /**
470 * Copy a driverfile from on connected share to another connected share
471 * This silently assumes that a driver-file is picked up from
472 *
473 * \\src_server\print$\{arch}\{version}\file
474 *
475 * and copied to
476 *
477 * \\dst_server\print$\{arch}\file
478 *
479 * to be added via setdriver-calls later.
480 * @param c A net_context structure
481 * @param mem_ctx A talloc-context
482 * @param cli_share_src A cli_state connected to source print$-share
483 * @param cli_share_dst A cli_state connected to destination print$-share
484 * @param file The file-name to be copied
485 * @param short_archi The name of the driver-architecture (short form)
486 *
487 * @return Normal NTSTATUS return.
488 **/
505 }
507 /* scroll through the file until we have the part
508 beyond archi_table.short_archi */
514 }
515 }
519 }
521 /* build source file name */
526 }
528 /* create destination file name */
532 }
535 /* finally copy the file */
538 }
540 /**
541 * Check for existing Architecture directory on a given server
542 *
543 * @param cli_share A cli_state connected to a print$-share
544 * @param short_archi The Architecture for the print-driver
545 *
546 * @return Normal NTSTATUS return.
547 **/
550 {
557 }
560 short_archi));
566 }
573 }
577 out:
580 }
582 /**
583 * Copy a print-driver (level 3) from one connected print$-share to another
584 * connected print$-share
585 *
586 * @param c A net_context structure
587 * @param mem_ctx A talloc-context
588 * @param cli_share_src A cli_state connected to a print$-share
589 * @param cli_share_dst A cli_state connected to a print$-share
590 * @param short_archi The Architecture for the print-driver
591 * @param i1 The DRIVER_INFO_3-struct
592 *
593 * @return Normal NTSTATUS return.
594 **/
602 {
608 }
642 }
643 }
646 }
648 /**
649 * net_spoolss-functions
650 * =====================
651 *
652 * the net_spoolss-functions aim to simplify spoolss-client-functions
653 * required during the migration-process wrt buffer-sizes, returned
654 * error-codes, etc.
655 *
656 * this greatly reduces the complexitiy of the migrate-functions.
657 *
658 **/
667 {
668 WERROR result;
670 /* enum printers */
673 flags,
674 name,
675 level,
677 num_printers,
678 info);
682 }
685 }
693 {
694 WERROR result;
695 fstring printername2;
704 /* open printer */
706 printername2,
707 access_required,
708 hnd);
710 /* be more verbose */
717 }
723 }
729 }
736 {
737 WERROR result;
739 /* getprinter call */
741 hnd,
742 level,
744 info);
748 }
751 }
758 {
760 WERROR result;
761 NTSTATUS status;
770 /* setprinter call */
815 #endif
818 }
821 hnd,
830 }
834 }
837 }
847 {
849 WERROR result;
850 NTSTATUS status;
852 /* setprinterdata call */
854 hnd,
855 value_name,
856 type,
857 data,
858 offered,
864 }
869 }
872 }
880 {
881 WERROR result;
883 /* enumprinterkey call */
889 }
892 }
901 {
902 WERROR result;
904 /* enumprinterdataex call */
906 hnd,
907 keyname,
909 count,
910 info);
915 }
918 }
926 {
928 WERROR result;
929 NTSTATUS status;
931 /* setprinterdataex call */
933 hnd,
934 keyname,
944 }
949 }
952 }
960 {
961 WERROR result;
963 /* enumforms call */
965 hnd,
966 level,
968 num_forms,
969 forms);
973 }
976 }
983 {
984 WERROR result;
986 /* enumprinterdrivers call */
989 env,
990 level,
992 count,
993 info);
1001 env);
1002 }
1003 }
1006 }
1013 {
1014 WERROR result;
1018 /* getprinterdriver call */
1020 hnd,
1021 env,
1022 level,
1024 version,
1026 info,
1036 }
1038 }
1041 }
1047 {
1049 WERROR result;
1050 NTSTATUS status;
1067 }
1069 /* addprinterdriver call */
1077 }
1078 /* be more verbose */
1082 }
1086 }
1089 }
1091 /**
1092 * abstraction function to get uint32_t num_printers and PRINTER_INFO_CTR ctr
1093 * for a single printer or for all printers depending on argc/argv
1094 **/
1103 {
1106 WERROR werr;
1108 /* no arguments given, enumerate all printers */
1117 }
1119 /* argument given, get a single printer by name */
1121 MAXIMUM_ALLOWED_ACCESS,
1129 }
1134 }
1140 out:
1145 }
1147 /**
1148 * List print-queues (including local printers that are not shared)
1149 *
1150 * All parameters are provided by the run_rpc_command function, except for
1151 * argc, argv which are passed through.
1152 *
1153 * @param c A net_context structure
1154 * @param domain_sid The domain sid aquired from the remote server
1155 * @param cli A cli_state connected to the server.
1156 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1157 * @param argc Standard main() style argc
1158 * @param argv Standard main() style argv. Initial components are already
1159 * stripped
1160 *
1161 * @return Normal NTSTATUS return.
1162 **/
1172 {
1186 /* do some initialization */
1193 }
1194 }
1197 }
1199 /**
1200 * List printer-drivers from a server
1201 *
1202 * All parameters are provided by the run_rpc_command function, except for
1203 * argc, argv which are passed through.
1204 *
1205 * @param c A net_context structure
1206 * @param domain_sid The domain sid aquired from the remote server
1207 * @param cli A cli_state connected to the server.
1208 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1209 * @param argc Standard main() style argc
1210 * @param argv Standard main() style argv. Initial components are already
1211 * stripped
1212 *
1213 * @return Normal NTSTATUS return.
1214 **/
1224 {
1237 /* enum remote drivers */
1243 }
1250 }
1256 /* do something for all drivers for architecture */
1259 }
1260 }
1264 done:
1267 }
1269 /**
1270 * Publish print-queues with args-wrapper
1271 *
1272 * @param cli A cli_state connected to the server.
1273 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1274 * @param argc Standard main() style argc
1275 * @param argv Standard main() style argv. Initial components are already
1276 * stripped
1277 * @param action
1278 *
1279 * @return Normal NTSTATUS return.
1280 **/
1287 {
1299 WERROR result;
1307 /* do some initialization */
1312 }
1314 /* open printer handle */
1319 /* check for existing dst printer */
1323 /* check action and set string */
1338 }
1359 }
1366 }
1369 }
1373 }
1377 done:
1380 }
1383 }
1393 {
1395 }
1405 {
1407 }
1417 {
1419 }
1421 /**
1422 * List print-queues w.r.t. their publishing state
1423 *
1424 * All parameters are provided by the run_rpc_command function, except for
1425 * argc, argv which are passed through.
1426 *
1427 * @param c A net_context structure
1428 * @param domain_sid The domain sid aquired from the remote server
1429 * @param cli A cli_state connected to the server.
1430 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1431 * @param argc Standard main() style argc
1432 * @param argv Standard main() style argv. Initial components are already
1433 * stripped
1434 *
1435 * @return Normal NTSTATUS return.
1436 **/
1446 {
1456 WERROR werr;
1463 /* do some initialization */
1469 }
1471 /* open printer handle */
1476 /* check for existing dst printer */
1482 }
1487 sharename);
1494 sharename);
1498 sharename);
1503 }
1504 }
1508 done:
1511 }
1514 }
1516 /**
1517 * Migrate Printer-ACLs from a source server to the destination server
1518 *
1519 * All parameters are provided by the run_rpc_command function, except for
1520 * argc, argv which are passed through.
1521 *
1522 * @param c A net_context structure
1523 * @param domain_sid The domain sid aquired from the remote server
1524 * @param cli A cli_state connected to the server.
1525 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1526 * @param argc Standard main() style argc
1527 * @param argv Standard main() style argv. Initial components are already
1528 * stripped
1529 *
1530 * @return Normal NTSTATUS return.
1531 **/
1541 {
1543 /* TODO: what now, info2 or info3 ?
1544 convince jerry that we should add clientside setacls level 3 at least
1545 */
1557 WERROR werr;
1561 /* connect destination PI_SPOOLSS */
1566 }
1569 /* enum source printers */
1573 }
1579 }
1581 /* do something for all printers */
1584 /* do some initialization */
1591 }
1593 /* we can reset NT_STATUS here because we do not
1594 get any real NT_STATUS-codes anymore from now on */
1600 /* according to msdn you have specify these access-rights
1601 to see the security descriptor
1602 - READ_CONTROL (DACL)
1603 - ACCESS_SYSTEM_SECURITY (SACL)
1604 */
1606 /* open src printer handle */
1611 /* open dst printer handle */
1616 /* check for existing dst printer */
1620 /* check for existing src printer */
1624 /* Copy Security Descriptor */
1626 /* copy secdesc (info level 2) */
1639 /* close printer handles here */
1642 }
1646 }
1648 }
1652 done:
1656 }
1660 }
1664 }
1666 }
1668 /**
1669 * Migrate printer-forms from a src server to the dst server
1670 *
1671 * All parameters are provided by the run_rpc_command function, except for
1672 * argc, argv which are passed through.
1673 *
1674 * @param c A net_context structure
1675 * @param domain_sid The domain sid aquired from the remote server
1676 * @param cli A cli_state connected to the server.
1677 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1678 * @param argc Standard main() style argc
1679 * @param argv Standard main() style argv. Initial components are already
1680 * stripped
1681 *
1682 * @return Normal NTSTATUS return.
1683 **/
1693 {
1696 WERROR result;
1712 /* connect destination PI_SPOOLSS */
1717 }
1720 /* enum src printers */
1724 }
1730 }
1732 /* do something for all printers */
1735 /* do some initialization */
1742 }
1743 /* we can reset NT_STATUS here because we do not
1744 get any real NT_STATUS-codes anymore from now on */
1751 /* open src printer handle */
1756 /* open dst printer handle */
1761 /* check for existing dst printer */
1765 /* finally migrate forms */
1775 NTSTATUS status;
1777 /* only migrate FORM_PRINTER types, according to jerry
1778 FORM_BUILTIN-types are hard-coded in samba */
1791 /* FIXME: there might be something wrong with samba's
1792 builtin-forms */
1796 info,
1802 }
1807 }
1811 }
1814 /* close printer handles here */
1817 }
1821 }
1822 }
1826 done:
1830 }
1834 }
1838 }
1840 }
1842 /**
1843 * Migrate printer-drivers from a src server to the dst server
1844 *
1845 * All parameters are provided by the run_rpc_command function, except for
1846 * argc, argv which are passed through.
1847 *
1848 * @param c A net_context structure
1849 * @param domain_sid The domain sid aquired from the remote server
1850 * @param cli A cli_state connected to the server.
1851 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1852 * @param argc Standard main() style argc
1853 * @param argv Standard main() style argv. Initial components are already
1854 * stripped
1855 *
1856 * @return Normal NTSTATUS return.
1857 **/
1867 {
1886 WERROR werr;
1894 }
1897 /* open print$-share on the src server */
1906 /* open print$-share on the dst server */
1915 /* enum src printers */
1919 }
1925 }
1928 /* do something for all printers */
1931 /* do some initialization */
1938 }
1940 /* we can reset NT_STATUS here because we do not
1941 get any real NT_STATUS-codes anymore from now on */
1947 /* open dst printer handle */
1952 /* check for existing dst printer */
1957 /* open src printer handle */
1959 MAXIMUM_ALLOWED_ACCESS,
1964 /* in a first step call getdriver for each shared printer (per arch)
1965 to get a list of all files that have to be copied */
1969 /* getdriver src */
1980 /* check arch dir */
1986 /* copy driver-files */
1994 /* adddriver dst */
1998 }
2003 }
2007 printername));
2009 }
2011 /* setdriver dst */
2017 }
2022 /* close dst */
2025 }
2027 /* close src */
2030 }
2031 }
2035 done:
2039 }
2041 /* close src */
2044 }
2048 }
2058 }
2060 /**
2061 * Migrate printer-queues from a src to the dst server
2062 * (requires a working "addprinter command" to be installed for the local smbd)
2063 *
2064 * All parameters are provided by the run_rpc_command function, except for
2065 * argc, argv which are passed through.
2066 *
2067 * @param c A net_context structure
2068 * @param domain_sid The domain sid aquired from the remote server
2069 * @param cli A cli_state connected to the server.
2070 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2071 * @param argc Standard main() style argc
2072 * @param argv Standard main() style argv. Initial components are already
2073 * stripped
2074 *
2075 * @return Normal NTSTATUS return.
2076 **/
2086 {
2088 WERROR result;
2103 /* connect destination PI_SPOOLSS */
2108 }
2111 /* enum printers */
2115 }
2121 }
2123 /* do something for all printers */
2128 /* do some initialization */
2135 }
2136 /* we can reset NT_STATUS here because we do not
2137 get any real NT_STATUS-codes anymore from now on */
2143 /* open dst printer handle */
2148 }
2150 /* check for existing dst printer */
2155 /* close printer handle here - dst only, not got src yet. */
2158 }
2160 }
2162 /* now get again src printer ctr via getprinter,
2163 we first need a handle for that */
2165 /* open src printer handle */
2170 /* getprinter on the src server */
2174 /* copy each src printer to a dst printer 1:1,
2175 maybe some values have to be changed though */
2183 mem_ctx,
2188 printername);
2191 printername);
2194 printername);
2196 }
2198 /* close printer handles here */
2201 }
2205 }
2206 }
2210 done:
2213 }
2217 }
2221 }
2223 }
2225 /**
2226 * Migrate Printer-Settings from a src server to the dst server
2227 * (for this to work, printers and drivers already have to be migrated earlier)
2228 *
2229 * All parameters are provided by the run_rpc_command function, except for
2230 * argc, argv which are passed through.
2231 *
2232 * @param c A net_context structure
2233 * @param domain_sid The domain sid aquired from the remote server
2234 * @param cli A cli_state connected to the server.
2235 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2236 * @param argc Standard main() style argc
2237 * @param argv Standard main() style argv. Initial components are already
2238 * stripped
2239 *
2240 * @return Normal NTSTATUS return.
2241 **/
2251 {
2254 /* FIXME: Here the nightmare begins */
2256 WERROR result;
2273 /* FIXME GD */
2278 /* connect destination PI_SPOOLSS */
2283 }
2286 /* enum src printers */
2290 }
2296 }
2299 /* needed for dns-strings in regkeys */
2304 }
2306 /* do something for all printers */
2314 /* do some initialization */
2321 }
2322 /* we can reset NT_STATUS here because we do not
2323 get any real NT_STATUS-codes anymore from now on */
2330 /* open src printer handle */
2335 /* open dst printer handle */
2340 /* check for existing dst printer */
2346 /* STEP 1: COPY DEVICE-MODE and other
2347 PRINTER_INFO_2-attributes
2348 */
2352 /* why is the port always disconnected when the printer
2353 is correctly installed (incl. driver ???) */
2356 /* check if printer is published */
2359 /* check for existing dst printer */
2365 /* ignore false from setprinter due to WERR_IO_PENDING */
2369 }
2373 /* copy devmode (info level 2) */
2376 /* do not copy security descriptor (we have another
2377 * command for that) */
2380 #if 0
2387 }
2388 #endif
2394 }
2396 /* STEP 2: COPY REGISTRY VALUES */
2398 /* please keep in mind that samba parse_spools gives horribly
2399 crippled results when used to rpccli_spoolss_enumprinterdataex
2400 a win2k3-server. (Bugzilla #1851)
2401 FIXME: IIRC I've seen it too on a win2k-server
2402 */
2414 /* enumerate data on src handle */
2422 /* loop for all printerdata of "PrinterDriverData" */
2429 /* loop for all reg_keys */
2432 /* display_value */
2444 }
2448 }
2450 /* set_value */
2458 }
2459 }
2461 /* STEP 3: COPY SUBKEY VALUES */
2463 /* here we need to enum all printer_keys and then work
2464 on the result with enum_printer_key_ex. nt4 does not
2465 respond to enumprinterkey, win2k does, so continue
2466 in case of an error */
2471 }
2474 /* work on a list of printer keys
2475 each key has to be enumerated to get all required
2476 information. information is then set via setprinterdataex-calls */
2487 /* enumerate all src subkeys */
2492 }
2497 DATA_BLOB blob;
2501 /* although samba replies with sane data in most cases we
2502 should try to avoid writing wrong registry data */
2512 /* although windows uses a multi-sz, we use a sz */
2514 }
2521 }
2523 }
2529 #if 0
2530 /* FIXME: should we really do that ??? */
2534 }
2537 #endif
2538 }
2543 }
2548 }
2552 REG_SZ,
2558 }
2563 /* here we have to set all subkeys on the dst server */
2566 {
2569 }
2584 }
2588 }
2590 /* here we have to set all subkeys on the dst server */
2594 }
2597 }
2602 }
2603 }
2607 /* close printer handles here */
2610 }
2614 }
2615 }
2619 done:
2626 }
2630 }
2634 }
2636 }