| blob | 8e022ac1f6c118038cb9eb561157fda7ccb897ed |
1 /*
2 * Unix SMB/Netbios implementation.
3 * Version 1.9.
4 * RPC Pipe client / server routines
5 * Copyright (C) Andrew Tridgell 1992-2000,
6 * Copyright (C) Jean François 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 2 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, write to the Free Software
20 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 */
38 #define NTDRIVERS_DATABASE_VERSION_1 1
39 #define NTDRIVERS_DATABASE_VERSION_2 2
41 #define NTDRIVERS_DATABASE_VERSION NTDRIVERS_DATABASE_VERSION_2
43 /* Map generic permissions to printer object specific permissions */
46 PRINTER_READ,
47 PRINTER_WRITE,
48 PRINTER_EXECUTE,
49 PRINTER_ALL_ACCESS
50 };
52 /* We need one default form to support our default printer. Msoft adds the
53 forms it wants and in the ORDER it wants them (note: DEVMODE papersize is an
54 array index). Letter is always first, so (for the current code) additions
55 always put things in the correct order. */
175 };
178 {
193 }
195 DEBUG(0,("upgrade_to_version_2: failed to delete form. Error (%s)\n", tdb_errorstr(tdb_drivers)));
197 }
198 }
203 DEBUG(0,("upgrade_to_version_2: failed to move printer. Error (%s)\n", tdb_errorstr(tdb_printers)));
205 }
207 DEBUG(0,("upgrade_to_version_2: failed to delete printer. Error (%s)\n", tdb_errorstr(tdb_drivers)));
209 }
210 }
215 DEBUG(0,("upgrade_to_version_2: failed to move secdesc. Error (%s)\n", tdb_errorstr(tdb_printers)));
217 }
219 DEBUG(0,("upgrade_to_version_2: failed to delete secdesc. Error (%s)\n", tdb_errorstr(tdb_drivers)));
221 }
222 }
225 }
228 }
230 /****************************************************************************
231 open the NT printing tdb
232 ****************************************************************************/
234 {
246 }
253 }
260 }
264 /* handle a Samba upgrade */
275 }
279 }
281 /****************************************************************************
282 get builtin form struct list
283 ****************************************************************************/
285 {
288 }
290 /****************************************************************************
291 get a builtin form struct
292 ****************************************************************************/
295 {
297 fstring form_name;
306 }
307 }
310 }
312 /****************************************************************************
313 get a form struct list
314 ****************************************************************************/
316 {
319 nt_forms_struct form;
343 }
346 n++;
347 }
351 }
353 /****************************************************************************
354 write a form struct list
355 ****************************************************************************/
357 {
364 /* save index, so list is rebuilt in correct order */
376 }
379 }
381 /****************************************************************************
382 add a form struct at the end of the list
383 ****************************************************************************/
385 {
387 BOOL update;
388 fstring form_name;
391 /*
392 * NT tries to add forms even when
393 * they are already in the base
394 * only update the values if already present
395 */
405 }
406 }
412 }
416 }
427 }
429 /****************************************************************************
430 delete a named form struct
431 ****************************************************************************/
433 {
434 pstring key;
435 TDB_DATA kbuf;
437 fstring form_name;
447 }
448 }
454 }
462 }
465 }
467 /****************************************************************************
468 update a form struct
469 ****************************************************************************/
471 {
473 fstring form_name;
478 {
482 }
493 }
495 /****************************************************************************
496 get the nt drivers list
498 traverse the database and look-up the matching names
499 ****************************************************************************/
501 {
503 fstring short_archi;
505 pstring key;
519 }
523 total++;
524 }
527 }
529 /****************************************************************************
530 function to do the mapping between the long architecture name and
531 the short one.
532 ****************************************************************************/
534 {
538 };
541 {
548 };
554 i++;
561 }
570 }
572 /****************************************************************************
573 Version information in Microsoft files is held in a VS_VERSION_INFO structure.
574 There are two case to be covered here: PE (Portable Executable) and NE (New
575 Executable) files. Both files support the same INFO structure, but PE files
576 store the signature in unicode, and NE files store it as !unicode.
577 ****************************************************************************/
580 {
583 ssize_t byte_count;
589 }
591 /* Note: DOS_HEADER_SIZE < malloc'ed PE_HEADER_SIZE */
596 }
598 /* Is this really a DOS header? */
603 }
605 /* Skip OEM header (if any) and the DOS stub to start of Windows header */
606 if (fsp->conn->vfs_ops.lseek(fsp, fsp->fd, SVAL(buf,DOS_HEADER_LFANEW_OFFSET), SEEK_SET) == (SMB_OFF_T)-1) {
609 /* Assume this isn't an error... the file just looks sort of like a PE/NE file */
611 }
616 /* Assume this isn't an error... the file just looks sort of like a PE/NE file */
618 }
620 /* The header may be a PE (Portable Executable) or an NE (New Executable) */
628 /* At this point, we assume the file is in error. It still could be somthing
629 * else besides a PE file, but it unlikely at this point.
630 */
632 }
634 /* get the section table */
642 }
648 }
650 /* Iterate the section table looking for the resource section ".rsrc" */
663 }
665 /* Seek to the start of the .rsrc section info */
670 }
676 }
679 /* Scan for 1st 3 unicoded bytes followed by word aligned magic value */
681 /* Align to next long address */
694 }
695 }
696 }
697 }
698 }
700 /* Version info not found, fall back to origin date/time */
709 /* At this point, we assume the file is in error. It still could be somthing
710 * else besides a NE file, but it unlikely at this point. */
712 }
714 /* Allocate a bit more space to speed up things */
720 }
722 /* This is a HACK! I got tired of trying to sort through the messy
723 * 'NE' file format. If anyone wants to clean this up please have at
724 * it, but this works. 'NE' files will eventually fade away. JRR */
726 /* Cover case that should not occur in a well formed 'NE' .dll file */
730 /* Fast skip past data that can't possibly match */
733 /* Potential match data crosses buf boundry, move it to beginning
734 * of buf, and fill the buf with as much as it will hold. */
745 }
751 }
753 /* Check that the full signature string and the magic number that
754 * follows exist (not a perfect solution, but the chances that this
755 * occurs in code is, well, remote. Yes I know I'm comparing the 'V'
756 * twice, as it is simpler to read the code. */
758 /* Compute skip alignment to next long address */
771 }
772 }
773 }
775 /* Version info not found, fall back to origin date/time */
781 /* Assume this isn't an error... the file just looks sort of like a PE/NE file */
785 no_version_info:
789 error_exit:
792 }
794 /****************************************************************************
795 Drivers for Microsoft systems contain multiple files. Often, multiple drivers
796 share one or more files. During the MS installation process files are checked
797 to insure that only a newer version of a shared file is installed over an
798 older version. There are several possibilities for this comparison. If there
799 is no previous version, the new one is newer (obviously). If either file is
800 missing the version info structure, compare the creation date (on Unix use
801 the modification date). Otherwise chose the numerically larger version number.
802 ****************************************************************************/
804 fstring old_file)
805 {
807 pstring filepath;
809 uint32 new_major;
810 uint32 new_minor;
813 uint32 old_major;
814 uint32 old_minor;
820 SMB_STRUCT_STAT st;
821 SMB_STRUCT_STAT stat_buf;
822 BOOL bad_path;
829 /* Get file version info (if available) for previous file (if it exists) */
839 /* Old file not found, so by definition new file is in fact newer */
850 old_file));
855 }
856 }
859 /* Get file version info (if available) for new file */
868 /* New file not found, this shouldn't occur if the caller did its job */
879 new_file));
884 }
885 }
889 /* Compare versions and choose the larger version number */
895 }
899 }
902 /* Compare modification time/dates and choose the newest time/date */
906 }
910 }
911 }
913 error_exit:
917 }
919 /****************************************************************************
920 Determine the correct cVersion associated with an architecture and driver
921 ****************************************************************************/
924 {
928 NTSTATUS nt_status;
929 pstring driverpath;
930 DATA_BLOB null_pw;
932 BOOL bad_path;
933 SMB_STRUCT_STAT st;
938 /* If architecture is Windows 95/98/ME, the version is always 0. */
942 }
944 /* connect to the print$ share under the same account as the user connected to the rpc pipe */
945 /* Null password is ok - we are already an authenticated user... */
956 }
958 /* We are temporarily becoming the connection user. */
963 }
965 /* Open the driver file (Portable Executable format) and determine the
966 * deriver the cversion. */
980 }
982 uint32 major;
983 uint32 minor;
990 }
992 /*
993 * This is a Microsoft'ism. See references in MSDN to VER_FILEVERSION
994 * for more details. Version in this case is not just the version of the
995 * file, but the version in the sense of kernal mode (2) vs. user mode
996 * (3) drivers. Other bits of the version fields are the version info.
997 * JRR 010716
998 */
1009 }
1013 }
1023 error_exit:
1031 }
1033 /****************************************************************************
1034 ****************************************************************************/
1037 {
1038 fstring architecture;
1039 fstring new_name;
1042 WERROR err;
1044 /* clean up the driver name.
1045 * we can get .\driver.dll
1046 * or worse c:\windows\system\driver.dll !
1047 */
1048 /* using an intermediate string to not have overlaping memcpy()'s */
1052 }
1057 }
1062 }
1067 }
1074 }
1075 }
1076 }
1080 /* jfm:7/16/2000 the client always sends the cversion=0.
1081 * The server should check which version the driver is by reading
1082 * the PE header of driver->driverpath.
1083 *
1084 * For Windows 95/98 the version is 0 (so the value sent is correct)
1085 * For Windows NT (the architecture doesn't matter)
1086 * NT 3.1: cversion=0
1087 * NT 3.5/3.51: cversion=1
1088 * NT 4: cversion=2
1089 * NT2K: cversion=3
1090 */
1096 }
1098 /****************************************************************************
1099 ****************************************************************************/
1102 {
1103 fstring architecture;
1104 fstring new_name;
1107 WERROR err;
1109 /* clean up the driver name.
1110 * we can get .\driver.dll
1111 * or worse c:\windows\system\driver.dll !
1112 */
1113 /* using an intermediate string to not have overlaping memcpy()'s */
1117 }
1122 }
1127 }
1132 }
1139 }
1140 }
1141 }
1145 /* jfm:7/16/2000 the client always sends the cversion=0.
1146 * The server should check which version the driver is by reading
1147 * the PE header of driver->driverpath.
1148 *
1149 * For Windows 95/98 the version is 0 (so the value sent is correct)
1150 * For Windows NT (the architecture doesn't matter)
1151 * NT 3.1: cversion=0
1152 * NT 3.5/3.51: cversion=1
1153 * NT 4: cversion=2
1154 * NT2K: cversion=3
1155 */
1161 }
1163 /****************************************************************************
1164 ****************************************************************************/
1167 {
1170 {
1174 }
1176 {
1180 }
1183 }
1184 }
1186 /****************************************************************************
1187 This function sucks and should be replaced. JRA.
1188 ****************************************************************************/
1190 static void convert_level_6_to_level3(NT_PRINTER_DRIVER_INFO_LEVEL_3 *dst, NT_PRINTER_DRIVER_INFO_LEVEL_6 *src)
1191 {
1203 }
1214 else
1216 }
1219 }
1221 #endif
1223 /****************************************************************************
1224 ****************************************************************************/
1227 {
1229 NT_PRINTER_DRIVER_INFO_LEVEL_3 converted_driver;
1230 fstring architecture;
1231 pstring new_dir;
1232 pstring old_name;
1233 pstring new_name;
1234 DATA_BLOB null_pw;
1236 NTSTATUS nt_status;
1250 }
1254 /* connect to the print$ share under the same account as the user connected to the rpc pipe */
1255 /* Null password is ok - we are already an authenticated user... */
1263 }
1265 /*
1266 * Save who we are - we are temporarily becoming the connection user.
1267 */
1275 }
1277 /*
1278 * make the directories version and version\driver_name
1279 * under the architecture directory.
1280 */
1285 /* For each driver file, archi\filexxx.yyy, if there is a duplicate file
1286 * listed for this driver which has already been moved, skip it (note:
1287 * drivers may list the same file name several times. Then check if the
1288 * file already exists in archi\cversion\, if so, check that the version
1289 * info (or time stamps if version info is unavailable) is newer (or the
1290 * date is later). If it is, move it to archi\cversion\filexxx.yyy.
1291 * Otherwise, delete the file.
1292 *
1293 * If a file is not moved to archi\cversion\ because of an error, all the
1294 * rest of the 'unmoved' driver files are removed from archi\. If one or
1295 * more of the driver's files was already moved to archi\cversion\, it
1296 * potentially leaves the driver in a partially updated state. Version
1297 * trauma will most likely occur if an client attempts to use any printer
1298 * bound to the driver. Perhaps a rewrite to make sure the moves can be
1299 * done is appropriate... later JRR
1300 */
1308 NTSTATUS status;
1316 }
1317 }
1318 else
1320 }
1327 NTSTATUS status;
1335 }
1336 }
1337 else
1339 }
1340 }
1348 NTSTATUS status;
1356 }
1357 }
1358 else
1360 }
1361 }
1370 NTSTATUS status;
1378 }
1379 }
1380 else
1382 }
1383 }
1395 }
1396 }
1401 NTSTATUS status;
1409 }
1410 }
1411 else
1413 }
1414 NextDriver: ;
1415 }
1416 }
1422 }
1424 /****************************************************************************
1425 ****************************************************************************/
1427 {
1429 fstring architecture;
1430 pstring directory;
1431 pstring temp_name;
1432 pstring key;
1439 /* The names are relative. We store them in the form: \print$\arch\version\driver.xxx
1440 * \\server is added in the rpc server layer.
1441 * It does make sense to NOT store the server's name in the printer TDB.
1442 */
1444 slprintf(directory, sizeof(directory)-1, "\\print$\\%s\\%d\\", architecture, driver->cversion);
1446 /* .inf files do not always list a file for each of the four standard files.
1447 * Don't prepend a path to a null filename, or client claims:
1448 * "The server on which the printer resides does not have a suitable
1449 * <printer driver name> printer driver installed. Click OK if you
1450 * wish to install the driver on your local machine."
1451 */
1455 }
1460 }
1465 }
1470 }
1475 slprintf(driver->dependentfiles[i], sizeof(driver->dependentfiles[i])-1, "%s%s", directory, temp_name);
1476 }
1477 }
1479 slprintf(key, sizeof(key)-1, "%s%s/%d/%s", DRIVERS_PREFIX, architecture, driver->cversion, driver->name);
1486 again:
1503 }
1504 }
1514 }
1518 }
1528 done:
1534 }
1536 /****************************************************************************
1537 ****************************************************************************/
1539 {
1540 NT_PRINTER_DRIVER_INFO_LEVEL_3 info3;
1555 }
1558 /****************************************************************************
1559 ****************************************************************************/
1560 static WERROR get_a_printer_driver_3_default(NT_PRINTER_DRIVER_INFO_LEVEL_3 **info_ptr, fstring in_prt, fstring in_arch)
1561 {
1562 NT_PRINTER_DRIVER_INFO_LEVEL_3 info;
1583 }
1585 /****************************************************************************
1586 ****************************************************************************/
1587 static WERROR get_a_printer_driver_3(NT_PRINTER_DRIVER_INFO_LEVEL_3 **info_ptr, fstring in_prt, fstring in_arch, uint32 version)
1588 {
1589 NT_PRINTER_DRIVER_INFO_LEVEL_3 driver;
1591 fstring architecture;
1594 pstring key;
1600 DEBUG(8,("get_a_printer_driver_3: [%s%s/%d/%s]\n", DRIVERS_PREFIX, architecture, version, in_prt));
1608 #if 0
1610 #else
1612 #endif
1633 }
1638 i++;
1639 }
1649 }
1654 }
1656 /****************************************************************************
1657 ****************************************************************************/
1659 {
1661 TDB_DATA kbuf;
1662 pstring key;
1683 }
1688 /*pstrcat(line, info3->name); pstrcat(line, ":");*/
1709 }
1714 }
1716 /****************************************************************************
1717 debugging function, dump at level 6 the struct in the logs
1718 ****************************************************************************/
1720 {
1721 uint32 result;
1728 {
1730 {
1750 }
1752 }
1754 }
1759 }
1762 }
1764 /****************************************************************************
1765 ****************************************************************************/
1767 {
1818 }
1823 }
1825 /****************************************************************************
1826 ****************************************************************************/
1828 {
1833 param,
1839 }
1844 }
1847 /****************************************************************************
1848 delete a printer - this just deletes the printer info file, any open
1849 handles are not affected
1850 ****************************************************************************/
1852 {
1853 pstring key;
1854 TDB_DATA kbuf;
1863 }
1865 /* FIXME!!! Reorder so this forward declaration is not necessary --jerry */
1868 /****************************************************************************
1869 ****************************************************************************/
1871 {
1872 pstring key;
1875 WERROR ret;
1878 /*
1879 * in addprinter: no servername and the printer is the name
1880 * in setprinter: servername is \\server
1881 * and printer is \\server\\printer
1882 *
1883 * Samba manages only local printers.
1884 * we currently don't support things like path=\\other_server\printer
1885 */
1891 }
1893 /*
1894 * JFM: one day I'll forget.
1895 * below that's info->portname because that's the SAMBA sharename
1896 * and I made NT 'thinks' it's the portname
1897 * the info->sharename is the thing you can name when you add a printer
1898 * that's the short-name when you create shared printer for 95/98
1899 * So I've made a limitation in SAMBA: you can only have 1 printer model
1900 * behind a SAMBA share.
1901 */
1906 again:
1944 }
1948 }
1960 done:
1970 }
1973 /****************************************************************************
1974 ****************************************************************************/
1976 {
1984 {
1986 }
1987 else
1988 {
1992 }
1994 }
1997 }
1999 /****************************************************************************
2000 ****************************************************************************/
2002 {
2019 }
2032 }
2036 }
2038 }
2040 /****************************************************************************
2041 Clean up and deallocate a (maybe partially) allocated NT_PRINTER_PARAM.
2042 ****************************************************************************/
2044 {
2054 }
2056 /****************************************************************************
2057 Malloc and return an NT devicemode.
2058 ****************************************************************************/
2061 {
2062 /*
2063 * should I init this ones ???
2064 nt_devmode->devicename
2065 */
2073 }
2107 /* non utilisés par un driver d'imprimante */
2121 }
2123 /****************************************************************************
2124 Deepcopy an NT devicemode.
2125 ****************************************************************************/
2128 {
2131 if ((new_nt_devicemode = (NT_DEVICEMODE *)memdup(nt_devicemode, sizeof(NT_DEVICEMODE))) == NULL) {
2134 }
2138 if ((new_nt_devicemode->private = memdup(nt_devicemode->private, nt_devicemode->driverextra)) == NULL) {
2142 }
2143 }
2146 }
2148 /****************************************************************************
2149 Clean up and deallocate a (maybe partially) allocated NT_DEVICEMODE.
2150 ****************************************************************************/
2153 {
2163 }
2165 /****************************************************************************
2166 Clean up and deallocate a (maybe partially) allocated NT_PRINTER_INFO_LEVEL_2.
2167 ****************************************************************************/
2169 {
2185 }
2188 }
2191 /****************************************************************************
2192 ****************************************************************************/
2194 {
2197 NT_DEVICEMODE devmode;
2245 /* the len in tdb_unpack is an int value and
2246 * devmode.driverextra is only a short
2247 */
2251 /* check to catch an invalid TDB entry so we don't segfault */
2254 }
2255 }
2264 }
2266 /****************************************************************************
2267 ****************************************************************************/
2269 {
2288 }
2291 }
2294 {
2311 }
2317 }
2323 }
2337 nt_name++;
2342 {
2346 l--;
2347 }
2348 }
2351 os2_name++;
2353 {
2357 l--;
2358 }
2359 }
2368 }
2369 }
2372 }
2374 /****************************************************************************
2375 get a default printer info 2 struct
2376 ****************************************************************************/
2378 {
2381 NT_PRINTER_INFO_LEVEL_2 info;
2394 /* by setting the driver name to an empty string, a local NT admin
2395 can now run the **local** APW to install a local printer driver
2396 for a Samba shared printer in 2.2. Without this, drivers **must** be
2397 installed on the Samba server for NT clients --jerry */
2401 #endif
2411 | PRINTER_ATTRIBUTE_LOCAL \
2412 | PRINTER_ATTRIBUTE_RAW_ONLY \
2421 /*
2422 * I changed this as I think it is better to have a generic
2423 * DEVMODE than to crash Win2k explorer.exe --jerry
2424 * See the HP Deskjet 990c Win2k drivers for an example.
2425 */
2429 #else
2430 /*
2431 * We should not return a default devicemode, as this causes
2432 * Win2K to not send the correct one on PCL drivers. It needs to
2433 * see a null devicemode so it can then overwrite the devicemode
2434 * on OpenPrinterEx. Yes this *is* insane :-). JRA.
2435 */
2438 #endif
2440 /* This will get the current RPC talloc context, but we should be
2441 passing this as a parameter... fixme... JRA ! */
2450 }
2454 fail:
2459 }
2461 /****************************************************************************
2462 ****************************************************************************/
2464 {
2465 pstring key;
2466 NT_PRINTER_INFO_LEVEL_2 info;
2470 fstring printername;
2507 /* Samba has to have shared raw drivers. */
2510 /* Restore the stripped strings. */
2517 #if 1
2518 /*
2519 * Some client drivers freak out if there is a NULL devmode
2520 * (probably the driver is not checking before accessing
2521 * the devmode pointer) --jerry
2522 */
2524 {
2526 printername));
2528 }
2529 #endif
2532 /* This will get the current RPC talloc context, but we should be
2533 passing this as a parameter... fixme... JRA ! */
2537 /* Fix for OS/2 drivers. */
2549 }
2551 /****************************************************************************
2552 debugging function, dump at level 6 the struct in the logs
2553 ****************************************************************************/
2555 {
2556 uint32 result;
2562 {
2564 {
2567 else
2568 {
2595 }
2597 }
2602 }
2605 }
2607 /****************************************************************************
2608 Get the parameters we can substitute in an NT print job.
2609 ****************************************************************************/
2611 void get_printer_subst_params(int snum, fstring *printername, fstring *sharename, fstring *portname)
2612 {
2625 }
2627 /*
2628 * The function below are the high level ones.
2629 * only those ones must be called from the spoolss code.
2630 * JFM.
2631 */
2633 /****************************************************************************
2634 Modify a printer. This is called from SETPRINTERDATA/DELETEPRINTERDATA.
2635 ****************************************************************************/
2638 {
2639 WERROR result;
2644 {
2646 {
2650 }
2654 }
2657 }
2659 /****************************************************************************
2660 Add a printer. This is called from ADDPRINTER(EX) and also SETPRINTER.
2661 We split this out from mod_a_printer as it updates the id's and timestamps.
2662 ****************************************************************************/
2665 {
2666 WERROR result;
2671 {
2673 {
2674 /*
2675 * Update the changestamp.
2676 * Note we must *not* do this in mod_a_printer().
2677 */
2678 NTTIME time_nt;
2683 else
2690 }
2694 }
2697 }
2699 /****************************************************************************
2700 Initialize printer devmode & data with previously saved driver init values.
2701 ****************************************************************************/
2703 {
2705 pstring key;
2708 NT_PRINTER_INFO_LEVEL_2 info;
2721 /*
2722 * Get the saved DEVMODE..
2723 */
2726 /*
2727 * The saved DEVMODE contains the devicename from the printer used during
2728 * the initialization save. Change it to reflect the new printer.
2729 */
2733 /*
2734 * Bind the saved DEVMODE to the new the printer.
2735 */
2742 /*
2743 * There should not be any printer data 'specifics' already set during the
2744 * add printer operation, if there are delete them.
2745 */
2750 }
2752 /*
2753 * Add the printer data 'specifics' to the new printer
2754 */
2760 }
2762 /****************************************************************************
2763 Initialize printer devmode & data with previously saved driver init values.
2764 When a printer is created using AddPrinter, the drivername bound to the
2765 printer is used to lookup previously saved driver initialization info, which
2766 is bound to the new printer.
2767 ****************************************************************************/
2770 {
2771 uint32 result;
2774 {
2776 {
2779 }
2783 }
2786 }
2788 /****************************************************************************
2789 Pack up the DEVMODE and specifics for a printer into a 'driver init' entry
2790 in the tdb. Note: this is different from the driver entry and the printer
2791 entry. There should be a single driver init entry for each driver regardless
2792 of whether it was installed from NT or 2K. Technically, they should be
2793 different, but they work out to the same struct.
2794 ****************************************************************************/
2796 {
2797 pstring key;
2805 again:
2819 }
2823 }
2834 done:
2840 DEBUG(10,("update_driver_init_2: Saved printer [%s] init DEVMODE & specifics for driver [%s]\n",
2844 }
2846 /****************************************************************************
2847 Update (i.e. save) the driver init info (DEVMODE and specifics) for a printer
2848 ****************************************************************************/
2851 {
2852 uint32 result;
2857 {
2859 {
2862 }
2866 }
2869 }
2871 /****************************************************************************
2872 Convert the printer data value, a REG_BINARY array, into an initialization
2873 DEVMODE. Note: the array must be parsed as if it was a DEVMODE in an rpc...
2874 got to keep the endians happy :).
2875 ****************************************************************************/
2877 static BOOL convert_driver_init(NT_PRINTER_PARAM *param, TALLOC_CTX *ctx, NT_DEVICEMODE *nt_devmode)
2878 {
2880 prs_struct ps;
2881 DEVICEMODE devmode;
2891 else
2895 }
2897 /****************************************************************************
2898 Set the DRIVER_INIT info in the tdb. Requires Win32 client code that:
2900 1. Use the driver's config DLL to this UNC printername and:
2901 a. Call DrvPrintEvent with PRINTER_EVENT_INITIALIZE
2902 b. Call DrvConvertDevMode with CDM_DRIVER_DEFAULT to get default DEVMODE
2903 2. Call SetPrinterData with the 'magic' key and the DEVMODE as data.
2905 The last step triggers saving the "driver initialization" information for
2906 this printer into the tdb. Later, new printers that use this driver will
2907 have this initialization information bound to them. This simulates the
2908 driver initialization, as if it had run on the Samba server (as it would
2909 have done on NT).
2911 The Win32 client side code requirement sucks! But until we can run arbitrary
2912 Win32 printer driver code on any Unix that Samba runs on, we are stuck with it.
2914 It would have been easier to use SetPrinter because all the UNMARSHALLING of
2915 the DEVMODE is done there, but 2K/XP clients do not set the DEVMODE... think
2916 about it and you will realize why. JRR 010720
2917 ****************************************************************************/
2920 {
2926 /*
2927 * Set devmode on printer info, so entire printer initialization can be
2928 * saved to tdb.
2929 */
2936 }
2940 /*
2941 * The DEVMODE is held in the 'data' component of the param in raw binary.
2942 * Convert it to to a devmode structure
2943 */
2948 }
2950 /*
2951 * Pack up and add (or update) the DEVMODE and any current printer data to
2952 * a 'driver init' element in the tdb
2953 *
2954 */
2960 }
2962 /*
2963 * If driver initialization info was successfully saved, set the current
2964 * printer to match it. This allows initialization of the current printer
2965 * as well as the driver.
2966 */
2971 }
2973 done:
2981 }
2983 /****************************************************************************
2984 Update the driver init info (DEVMODE and specifics) for a printer
2985 ****************************************************************************/
2988 {
2992 {
2994 {
2997 }
3001 }
3004 }
3006 /****************************************************************************
3007 Get a NT_PRINTER_INFO_LEVEL struct. It returns malloced memory.
3008 ****************************************************************************/
3011 {
3012 WERROR result;
3020 {
3022 {
3026 }
3034 }
3036 }
3040 }
3042 DEBUG(10,("get_a_printer: [%s] level %u returning %s\n", sharename, (unsigned int)level, werror_str(result)));
3045 }
3047 /****************************************************************************
3048 Deletes a NT_PRINTER_INFO_LEVEL struct.
3049 ****************************************************************************/
3052 {
3053 uint32 result;
3062 {
3064 {
3066 {
3069 }
3070 else
3071 {
3073 }
3075 }
3079 }
3083 }
3085 /****************************************************************************
3086 ****************************************************************************/
3088 {
3089 uint32 result;
3094 {
3096 {
3099 }
3102 {
3105 }
3109 }
3112 }
3113 /****************************************************************************
3114 ****************************************************************************/
3117 {
3118 WERROR result;
3121 {
3123 {
3126 }
3130 }
3135 }
3137 /****************************************************************************
3138 ****************************************************************************/
3140 {
3141 uint32 result;
3144 {
3146 {
3149 {
3155 }
3156 else
3157 {
3159 }
3161 }
3163 {
3166 {
3173 }
3174 else
3175 {
3177 }
3179 }
3183 }
3185 }
3188 /****************************************************************************
3189 Determine whether or not a particular driver is currently assigned
3190 to a printer
3191 ****************************************************************************/
3193 {
3195 NT_PRINTER_INFO_LEVEL_2 info;
3204 /* loop through the printers.tdb and check for the drivername */
3207 {
3246 }
3252 {
3256 }
3257 }
3262 /* report that the driver is in use by default */
3264 }
3266 /****************************************************************************
3267 Remove a printer driver from the TDB. This assumes that the the driver was
3268 previously looked up.
3269 ***************************************************************************/
3271 {
3272 pstring key;
3273 fstring arch;
3274 TDB_DATA kbuf;
3288 }
3294 }
3295 /****************************************************************************
3296 ****************************************************************************/
3297 BOOL get_specific_param_by_index(NT_PRINTER_INFO_LEVEL printer, uint32 level, uint32 param_index,
3299 {
3300 /* right now that's enough ! */
3308 i++;
3309 }
3314 /* exited because it exist */
3324 }
3326 /****************************************************************************
3327 ****************************************************************************/
3330 {
3331 /* right now that's enough ! */
3339 {
3342 #else
3344 #endif
3349 }
3352 {
3354 /* exited because it exist */
3365 }
3368 }
3370 /****************************************************************************
3371 Store a security desc for a printer.
3372 ****************************************************************************/
3375 {
3378 prs_struct ps;
3380 fstring key;
3381 WERROR status;
3387 /* The old owner and group sids of the security descriptor are not
3388 present when new ACEs are added or removed by changing printer
3389 permissions through NT. If they are NULL in the new security
3390 descriptor then copy them over from the old one. */
3400 /* Pick out correct owner and group sids */
3418 /* Make a deep copy of the security descriptor */
3422 sacl,
3423 dacl,
3427 }
3431 }
3433 /* Store the security descriptor in a tdb */
3442 }
3451 }
3453 /* Free malloc'ed memory */
3455 out:
3461 }
3463 /****************************************************************************
3464 Construct a default security descriptor buffer for a printer.
3465 ****************************************************************************/
3468 {
3470 SEC_ACCESS sa;
3474 DOM_SID owner_sid;
3478 /* Create an ACE where Everyone is allowed to print */
3484 /* Make the security descriptor owned by the Administrators group
3485 on the PDC of the domain. */
3490 uint32 owner_rid;
3492 /* Backup plan - make printer owned by admins or root.
3493 This should emulate a lanman printer as security
3494 settings can't be changed. */
3503 }
3504 }
3509 SEC_ACE_FLAG_INHERIT_ONLY);
3515 /* The ACL revision number in rpc_secdesc.h differs from the one
3516 created by NT when setting ACE entries in printer
3517 descriptors. NT4 complains about the property being edited by a
3518 NT5 machine. */
3524 }
3529 }
3537 }
3539 /****************************************************************************
3540 Get a security desc for a printer.
3541 ****************************************************************************/
3544 {
3545 prs_struct ps;
3546 fstring key;
3551 }
3553 /* Fetch security descriptor from tdb */
3564 }
3567 }
3569 /* If security descriptor is owned by S-1-1-0 and winbindd is up,
3570 this security descriptor has been created when winbindd was
3571 down. Take ownership of security descriptor. */
3574 DOM_SID owner_sid;
3577 /* Change sd owner to workgroup administrator */
3585 /* Create new sd */
3598 /* Swap with other one */
3602 /* Set it */
3605 }
3606 }
3616 fstring sid_str;
3623 }
3624 }
3628 }
3630 /* error code:
3631 0: everything OK
3632 1: level not implemented
3633 2: file doesn't exist
3634 3: can't allocate memory
3635 4: can't free memory
3636 5: non existant struct
3637 */
3639 /*
3640 A printer and a printer driver are 2 different things.
3641 NT manages them separatelly, Samba does the same.
3642 Why ? Simply because it's easier and it makes sense !
3644 Now explanation: You have 3 printers behind your samba server,
3645 2 of them are the same make and model (laser A and B). But laser B
3646 has an 3000 sheet feeder and laser A doesn't such an option.
3647 Your third printer is an old dot-matrix model for the accounting :-).
3649 If the /usr/local/samba/lib directory (default dir), you will have
3650 5 files to describe all of this.
3652 3 files for the printers (1 by printer):
3653 NTprinter_laser A
3654 NTprinter_laser B
3655 NTprinter_accounting
3656 2 files for the drivers (1 for the laser and 1 for the dot matrix)
3657 NTdriver_printer model X
3658 NTdriver_printer model Y
3660 jfm: I should use this comment for the text file to explain
3661 same thing for the forms BTW.
3662 Je devrais mettre mes commentaires en francais, ca serait mieux :-)
3664 */
3666 /* Convert generic access rights to printer object specific access rights.
3667 It turns out that NT4 security descriptors use generic access rights and
3668 NT5 the object specific ones. */
3671 {
3677 }
3678 }
3680 /****************************************************************************
3681 Check a user has permissions to perform the given operation. We use the
3682 permission constants defined in include/rpc_spoolss.h to check the various
3683 actions we perform when checking printer access.
3685 PRINTER_ACCESS_ADMINISTER:
3686 print_queue_pause, print_queue_resume, update_printer_sec,
3687 update_printer, spoolss_addprinterex_level_2,
3688 _spoolss_setprinterdata
3690 PRINTER_ACCESS_USE:
3691 print_job_start
3693 JOB_ACCESS_ADMINISTER:
3694 print_job_delete, print_job_pause, print_job_resume,
3695 print_queue_purge
3697 ****************************************************************************/
3699 {
3701 uint32 access_granted;
3702 NTSTATUS status;
3703 BOOL result;
3708 /* If user is NULL then use the current_user structure */
3713 /* Always allow root or printer admins to do anything */
3718 }
3720 /* Get printer name */
3727 }
3729 /* Get printer security descriptor */
3734 }
3741 /* Create a child security descriptor to check permissions
3742 against. This is because print jobs are child objects
3743 objects of a printer. */
3747 /* Now this is the bit that really confuses me. The access
3748 type needs to be changed from JOB_ACCESS_ADMINISTER to
3749 PRINTER_ACCESS_ADMINISTER for this to work. Something
3750 to do with the child (job) object becoming like a
3751 printer?? -tpot */
3754 }
3756 /* Check access */
3771 }
3773 /****************************************************************************
3774 Check the time parameters allow a print operation.
3775 *****************************************************************************/
3778 {
3783 uint32 mins;
3803 }
3805 /****************************************************************************
3806 Attempt to write a default device.
3807 *****************************************************************************/
3810 {
3812 WERROR result;
3814 /*
3815 * Don't bother if no default devicemode was sent.
3816 */
3824 /*
3825 * Just ignore it if we already have a devmode.
3826 */
3827 #if 0
3830 #endif
3831 /*
3832 * We don't have a devicemode and we're trying to write
3833 * one. Check we have the access needed.
3834 */
3838 PRINTER_ACCESS_ADMINISTER) {
3839 DEBUG(5,("printer_write_default_dev: invalid request access to update: %x\n", printer_default->access_required));
3842 }
3848 /*result = NT_STATUS_NO_PROBLEMO;*/
3850 }
3854 /*
3855 * Convert the on the wire devicemode format to the internal one.
3856 */
3863 }
3865 /*
3866 * Finally write back to the tdb.
3867 */
3871 done:
3875 }