| blob | f5247b29352ddf9f7abf88f3059dc800f826bd4e |
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 */
33 /* support itanium as well */
45 };
48 /**
49 * This display-printdriver-functions was borrowed from rpcclient/cmd_spoolss.c.
50 * It is here for debugging purpose and should be removed later on.
51 **/
53 /****************************************************************************
54 Printer info level 3 display function.
55 ****************************************************************************/
58 {
63 }
76 }
82 }
84 static void display_reg_value(const char *subkey, const char *name, struct registry_value *value)
85 {
95 name);
96 }
103 }
120 }
125 }
128 }
132 }
134 }
136 /**
137 * Copies ACLs, DOS-attributes and timestamps from one
138 * file or directory from one connected share to another connected share
139 *
140 * @param c A net_context structure
141 * @param mem_ctx A talloc-context
142 * @param cli_share_src A connected cli_state
143 * @param cli_share_dst A connected cli_state
144 * @param src_file The source file-name
145 * @param dst_file The destination file-name
146 * @param copy_acls Whether to copy acls
147 * @param copy_attrs Whether to copy DOS attributes
148 * @param copy_timestamps Whether to preserve timestamps
149 * @param is_file Whether this file is a file or a dir
150 *
151 * @return Normal NTSTATUS return.
152 **/
161 {
162 NTSTATUS nt_status;
172 /* open file/dir on the originating server */
185 }
188 /* get the security descriptor */
195 }
199 }
203 /* get file attributes */
210 }
211 }
213 /* open the file/dir on the destination server */
222 }
225 /* set timestamps */
231 }
232 }
235 /* set acls */
241 }
242 }
245 /* set attrs */
251 }
252 }
255 /* closing files */
262 }
270 }
275 out:
277 /* cleaning up */
285 }
287 /**
288 * Copy a file or directory from a connected share to another connected share
289 *
290 * @param c A net_context structure
291 * @param mem_ctx A talloc-context
292 * @param cli_share_src A connected cli_state
293 * @param cli_share_dst A connected cli_state
294 * @param src_file The source file-name
295 * @param dst_file The destination file-name
296 * @param copy_acls Whether to copy acls
297 * @param copy_attrs Whether to copy DOS attributes
298 * @param copy_timestamps Whether to preserve timestamps
299 * @param is_file Whether this file is a file or a dir
300 *
301 * @return Normal NTSTATUS return.
302 **/
311 {
327 /* open on the originating server */
332 else
342 }
347 /* open file on the destination server */
356 }
358 /* allocate memory */
361 read_size);
364 }
366 }
380 }
385 /* copying file */
397 }
412 }
415 }
420 /* creating dir */
422 dst_name));
429 }
438 }
439 }
442 /* closing files */
449 }
458 }
459 }
461 /* possibly we have to copy some file-attributes / acls / sd */
471 out:
473 /* cleaning up */
483 }
485 /**
486 * Copy a driverfile from on connected share to another connected share
487 * This silently assumes that a driver-file is picked up from
488 *
489 * \\src_server\print$\{arch}\{version}\file
490 *
491 * and copied to
492 *
493 * \\dst_server\print$\{arch}\file
494 *
495 * to be added via setdriver-calls later.
496 * @param c A net_context structure
497 * @param mem_ctx A talloc-context
498 * @param cli_share_src A cli_state connected to source print$-share
499 * @param cli_share_dst A cli_state connected to destination print$-share
500 * @param file The file-name to be copied
501 * @param short_archi The name of the driver-architecture (short form)
502 *
503 * @return Normal NTSTATUS return.
504 **/
521 }
523 /* scroll through the file until we have the part
524 beyond archi_table.short_archi */
530 }
531 }
535 }
537 /* build source file name */
542 }
544 /* create destination file name */
548 }
551 /* finally copy the file */
554 }
556 /**
557 * Check for existing Architecture directory on a given server
558 *
559 * @param cli_share A cli_state connected to a print$-share
560 * @param short_archi The Architecture for the print-driver
561 *
562 * @return Normal NTSTATUS return.
563 **/
566 {
573 }
576 short_archi));
582 }
589 }
593 out:
596 }
598 /**
599 * Copy a print-driver (level 3) from one connected print$-share to another
600 * connected print$-share
601 *
602 * @param c A net_context structure
603 * @param mem_ctx A talloc-context
604 * @param cli_share_src A cli_state connected to a print$-share
605 * @param cli_share_dst A cli_state connected to a print$-share
606 * @param short_archi The Architecture for the print-driver
607 * @param i1 The DRIVER_INFO_3-struct
608 *
609 * @return Normal NTSTATUS return.
610 **/
618 {
624 }
658 }
659 }
662 }
664 /**
665 * net_spoolss-functions
666 * =====================
667 *
668 * the net_spoolss-functions aim to simplify spoolss-client-functions
669 * required during the migration-process wrt buffer-sizes, returned
670 * error-codes, etc.
671 *
672 * this greatly reduces the complexitiy of the migrate-functions.
673 *
674 **/
683 {
684 WERROR result;
686 /* enum printers */
689 flags,
690 name,
691 level,
693 num_printers,
694 info);
698 }
701 }
709 {
710 WERROR result;
711 fstring printername2;
720 /* open printer */
722 printername2,
723 access_required,
724 hnd);
726 /* be more verbose */
733 }
739 }
745 }
752 {
753 WERROR result;
755 /* getprinter call */
757 hnd,
758 level,
760 info);
764 }
767 }
774 {
776 WERROR result;
777 NTSTATUS status;
786 /* setprinter call */
831 #endif
834 }
837 hnd,
846 }
850 }
853 }
863 {
865 WERROR result;
866 NTSTATUS status;
868 /* setprinterdata call */
870 hnd,
871 value_name,
872 type,
873 data,
874 offered,
880 }
885 }
888 }
896 {
897 WERROR result;
899 /* enumprinterkey call */
905 }
908 }
917 {
918 WERROR result;
920 /* enumprinterdataex call */
922 hnd,
923 keyname,
925 count,
926 info);
931 }
934 }
943 {
945 WERROR result;
946 NTSTATUS status;
948 /* setprinterdataex call */
950 hnd,
951 keyname,
952 name,
961 }
966 }
969 }
977 {
978 WERROR result;
980 /* enumforms call */
982 hnd,
983 level,
985 num_forms,
986 forms);
990 }
993 }
1000 {
1001 WERROR result;
1003 /* enumprinterdrivers call */
1006 env,
1007 level,
1009 count,
1010 info);
1018 env);
1019 }
1020 }
1023 }
1030 {
1031 WERROR result;
1035 /* getprinterdriver call */
1037 hnd,
1038 env,
1039 level,
1041 version,
1043 info,
1053 }
1055 }
1058 }
1064 {
1066 WERROR result;
1067 NTSTATUS status;
1084 }
1086 /* addprinterdriver call */
1094 }
1095 /* be more verbose */
1099 }
1103 }
1106 }
1108 /**
1109 * abstraction function to get uint32_t num_printers and PRINTER_INFO_CTR ctr
1110 * for a single printer or for all printers depending on argc/argv
1111 **/
1120 {
1123 WERROR werr;
1125 /* no arguments given, enumerate all printers */
1134 }
1136 /* argument given, get a single printer by name */
1138 MAXIMUM_ALLOWED_ACCESS,
1146 }
1151 }
1157 out:
1162 }
1164 /**
1165 * List print-queues (including local printers that are not shared)
1166 *
1167 * All parameters are provided by the run_rpc_command function, except for
1168 * argc, argv which are passed through.
1169 *
1170 * @param c A net_context structure
1171 * @param domain_sid The domain sid aquired from the remote server
1172 * @param cli A cli_state connected to the server.
1173 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1174 * @param argc Standard main() style argc
1175 * @param argv Standard main() style argv. Initial components are already
1176 * stripped
1177 *
1178 * @return Normal NTSTATUS return.
1179 **/
1189 {
1203 /* do some initialization */
1210 }
1211 }
1214 }
1216 /**
1217 * List printer-drivers from a server
1218 *
1219 * All parameters are provided by the run_rpc_command function, except for
1220 * argc, argv which are passed through.
1221 *
1222 * @param c A net_context structure
1223 * @param domain_sid The domain sid aquired from the remote server
1224 * @param cli A cli_state connected to the server.
1225 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1226 * @param argc Standard main() style argc
1227 * @param argv Standard main() style argv. Initial components are already
1228 * stripped
1229 *
1230 * @return Normal NTSTATUS return.
1231 **/
1241 {
1254 /* enum remote drivers */
1260 }
1267 }
1273 /* do something for all drivers for architecture */
1276 }
1277 }
1281 done:
1284 }
1286 /**
1287 * Publish print-queues with args-wrapper
1288 *
1289 * @param cli A cli_state connected to the server.
1290 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1291 * @param argc Standard main() style argc
1292 * @param argv Standard main() style argv. Initial components are already
1293 * stripped
1294 * @param action
1295 *
1296 * @return Normal NTSTATUS return.
1297 **/
1304 {
1316 WERROR result;
1324 /* do some initialization */
1329 }
1331 /* open printer handle */
1336 /* check for existing dst printer */
1340 /* check action and set string */
1355 }
1376 }
1383 }
1386 }
1390 }
1394 done:
1397 }
1400 }
1410 {
1412 }
1422 {
1424 }
1434 {
1436 }
1438 /**
1439 * List print-queues w.r.t. their publishing state
1440 *
1441 * All parameters are provided by the run_rpc_command function, except for
1442 * argc, argv which are passed through.
1443 *
1444 * @param c A net_context structure
1445 * @param domain_sid The domain sid aquired from the remote server
1446 * @param cli A cli_state connected to the server.
1447 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1448 * @param argc Standard main() style argc
1449 * @param argv Standard main() style argv. Initial components are already
1450 * stripped
1451 *
1452 * @return Normal NTSTATUS return.
1453 **/
1463 {
1473 WERROR werr;
1480 /* do some initialization */
1486 }
1488 /* open printer handle */
1493 /* check for existing dst printer */
1499 }
1504 sharename);
1511 sharename);
1515 sharename);
1520 }
1521 }
1525 done:
1528 }
1531 }
1533 /**
1534 * Migrate Printer-ACLs from a source server to the destination server
1535 *
1536 * All parameters are provided by the run_rpc_command function, except for
1537 * argc, argv which are passed through.
1538 *
1539 * @param c A net_context structure
1540 * @param domain_sid The domain sid aquired from the remote server
1541 * @param cli A cli_state connected to the server.
1542 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1543 * @param argc Standard main() style argc
1544 * @param argv Standard main() style argv. Initial components are already
1545 * stripped
1546 *
1547 * @return Normal NTSTATUS return.
1548 **/
1558 {
1560 /* TODO: what now, info2 or info3 ?
1561 convince jerry that we should add clientside setacls level 3 at least
1562 */
1575 WERROR werr;
1579 /* connect destination PI_SPOOLSS */
1584 }
1587 /* enum source printers */
1591 }
1597 }
1599 /* do something for all printers */
1602 /* do some initialization */
1609 }
1611 /* we can reset NT_STATUS here because we do not
1612 get any real NT_STATUS-codes anymore from now on */
1618 /* according to msdn you have specify these access-rights
1619 to see the security descriptor
1620 - READ_CONTROL (DACL)
1621 - ACCESS_SYSTEM_SECURITY (SACL)
1622 */
1624 /* open src printer handle */
1629 /* open dst printer handle */
1634 /* check for existing dst printer */
1638 /* check for existing src printer */
1642 /* Copy Security Descriptor */
1644 /* copy secdesc (info level 2) */
1655 }
1656 }
1667 /* close printer handles here */
1670 }
1674 }
1676 }
1680 done:
1684 }
1688 }
1692 }
1694 }
1696 /**
1697 * Migrate printer-forms from a src server to the dst server
1698 *
1699 * All parameters are provided by the run_rpc_command function, except for
1700 * argc, argv which are passed through.
1701 *
1702 * @param c A net_context structure
1703 * @param domain_sid The domain sid aquired from the remote server
1704 * @param cli A cli_state connected to the server.
1705 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1706 * @param argc Standard main() style argc
1707 * @param argv Standard main() style argv. Initial components are already
1708 * stripped
1709 *
1710 * @return Normal NTSTATUS return.
1711 **/
1721 {
1724 WERROR result;
1741 /* connect destination PI_SPOOLSS */
1746 }
1749 /* enum src printers */
1753 }
1759 }
1761 /* do something for all printers */
1764 /* do some initialization */
1771 }
1772 /* we can reset NT_STATUS here because we do not
1773 get any real NT_STATUS-codes anymore from now on */
1780 /* open src printer handle */
1785 /* open dst printer handle */
1790 /* check for existing dst printer */
1794 /* finally migrate forms */
1804 NTSTATUS status;
1806 /* only migrate FORM_PRINTER types, according to jerry
1807 FORM_BUILTIN-types are hard-coded in samba */
1820 /* FIXME: there might be something wrong with samba's
1821 builtin-forms */
1830 }
1835 }
1839 }
1842 /* close printer handles here */
1845 }
1849 }
1850 }
1854 done:
1858 }
1862 }
1866 }
1868 }
1870 /**
1871 * Migrate printer-drivers from a src server to the dst server
1872 *
1873 * All parameters are provided by the run_rpc_command function, except for
1874 * argc, argv which are passed through.
1875 *
1876 * @param c A net_context structure
1877 * @param domain_sid The domain sid aquired from the remote server
1878 * @param cli A cli_state connected to the server.
1879 * @param mem_ctx Talloc context, destoyed on compleation of the function.
1880 * @param argc Standard main() style argc
1881 * @param argv Standard main() style argv. Initial components are already
1882 * stripped
1883 *
1884 * @return Normal NTSTATUS return.
1885 **/
1895 {
1915 WERROR werr;
1923 }
1926 /* open print$-share on the src server */
1937 /* open print$-share on the dst server */
1948 /* enum src printers */
1952 }
1958 }
1961 /* do something for all printers */
1964 /* do some initialization */
1971 }
1973 /* we can reset NT_STATUS here because we do not
1974 get any real NT_STATUS-codes anymore from now on */
1980 /* open dst printer handle */
1985 /* check for existing dst printer */
1990 /* open src printer handle */
1992 MAXIMUM_ALLOWED_ACCESS,
1997 /* in a first step call getdriver for each shared printer (per arch)
1998 to get a list of all files that have to be copied */
2002 /* getdriver src */
2013 /* check arch dir */
2019 /* copy driver-files */
2027 /* adddriver dst */
2031 }
2036 }
2040 printername));
2042 }
2044 /* setdriver dst */
2050 }
2055 /* close dst */
2058 }
2060 /* close src */
2063 }
2064 }
2068 done:
2072 }
2074 /* close src */
2077 }
2081 }
2091 }
2093 /**
2094 * Migrate printer-queues from a src to the dst server
2095 * (requires a working "addprinter command" to be installed for the local smbd)
2096 *
2097 * All parameters are provided by the run_rpc_command function, except for
2098 * argc, argv which are passed through.
2099 *
2100 * @param c A net_context structure
2101 * @param domain_sid The domain sid aquired from the remote server
2102 * @param cli A cli_state connected to the server.
2103 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2104 * @param argc Standard main() style argc
2105 * @param argv Standard main() style argv. Initial components are already
2106 * stripped
2107 *
2108 * @return Normal NTSTATUS return.
2109 **/
2119 {
2121 WERROR result;
2137 /* connect destination PI_SPOOLSS */
2142 }
2145 /* enum printers */
2149 }
2155 }
2157 /* do something for all printers */
2162 /* do some initialization */
2169 }
2170 /* we can reset NT_STATUS here because we do not
2171 get any real NT_STATUS-codes anymore from now on */
2177 /* open dst printer handle */
2182 }
2184 /* check for existing dst printer */
2189 /* close printer handle here - dst only, not got src yet. */
2192 }
2194 }
2196 /* now get again src printer ctr via getprinter,
2197 we first need a handle for that */
2199 /* open src printer handle */
2204 /* getprinter on the src server */
2208 /* copy each src printer to a dst printer 1:1,
2209 maybe some values have to be changed though */
2217 mem_ctx,
2222 printername);
2225 printername);
2228 printername);
2230 }
2232 /* close printer handles here */
2235 }
2239 }
2240 }
2244 done:
2247 }
2251 }
2255 }
2257 }
2259 /**
2260 * Migrate Printer-Settings from a src server to the dst server
2261 * (for this to work, printers and drivers already have to be migrated earlier)
2262 *
2263 * All parameters are provided by the run_rpc_command function, except for
2264 * argc, argv which are passed through.
2265 *
2266 * @param c A net_context structure
2267 * @param domain_sid The domain sid aquired from the remote server
2268 * @param cli A cli_state connected to the server.
2269 * @param mem_ctx Talloc context, destoyed on compleation of the function.
2270 * @param argc Standard main() style argc
2271 * @param argv Standard main() style argv. Initial components are already
2272 * stripped
2273 *
2274 * @return Normal NTSTATUS return.
2275 **/
2285 {
2288 /* FIXME: Here the nightmare begins */
2290 WERROR result;
2307 /* FIXME GD */
2312 /* connect destination PI_SPOOLSS */
2317 }
2320 /* enum src printers */
2324 }
2330 }
2333 /* needed for dns-strings in regkeys */
2338 }
2340 /* do something for all printers */
2348 /* do some initialization */
2355 }
2356 /* we can reset NT_STATUS here because we do not
2357 get any real NT_STATUS-codes anymore from now on */
2364 /* open src printer handle */
2369 /* open dst printer handle */
2374 /* check for existing dst printer */
2380 /* STEP 1: COPY DEVICE-MODE and other
2381 PRINTER_INFO_2-attributes
2382 */
2386 /* why is the port always disconnected when the printer
2387 is correctly installed (incl. driver ???) */
2390 /* check if printer is published */
2393 /* check for existing dst printer */
2399 /* ignore false from setprinter due to WERR_IO_PENDING */
2403 }
2407 /* copy devmode (info level 2) */
2410 /* do not copy security descriptor (we have another
2411 * command for that) */
2414 #if 0
2421 }
2422 #endif
2428 }
2430 /* STEP 2: COPY REGISTRY VALUES */
2432 /* please keep in mind that samba parse_spools gives horribly
2433 crippled results when used to rpccli_spoolss_enumprinterdataex
2434 a win2k3-server. (Bugzilla #1851)
2435 FIXME: IIRC I've seen it too on a win2k-server
2436 */
2448 /* enumerate data on src handle */
2456 /* loop for all printerdata of "PrinterDriverData" */
2463 /* loop for all reg_keys */
2466 /* display_value */
2475 }
2477 /* set_value */
2485 }
2486 }
2488 /* STEP 3: COPY SUBKEY VALUES */
2490 /* here we need to enum all printer_keys and then work
2491 on the result with enum_printer_key_ex. nt4 does not
2492 respond to enumprinterkey, win2k does, so continue
2493 in case of an error */
2498 }
2501 /* work on a list of printer keys
2502 each key has to be enumerated to get all required
2503 information. information is then set via setprinterdataex-calls */
2514 /* enumerate all src subkeys */
2519 }
2529 /* although samba replies with sane data in most cases we
2530 should try to avoid writing wrong registry data */
2533 /* although windows uses a multi-sz, we use a sz */
2538 }
2539 }
2545 }
2550 }
2552 }
2555 #if 0
2556 /* FIXME: should we really do that ??? */
2560 }
2563 #endif
2564 }
2570 }
2571 }
2577 }
2578 }
2582 }
2586 }
2588 /* here we have to set all subkeys on the dst server */
2591 {
2593 }
2598 }
2599 }
2603 /* close printer handles here */
2606 }
2610 }
2611 }
2615 done:
2618 }
2622 }
2626 }
2628 }