| blob | 0670b2543eb36bce2c181fd58edd04c19758ec30 |
1 /*
2 * Unix SMB/CIFS implementation.
3 * RPC Pipe client / server routines
4 * Copyright (C) Andrew Tridgell 1992-2000,
5 * Copyright (C) Jean François Micouleau 1998-2000.
6 * Copyright (C) Gerald Carter 2002-2003.
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
42 #define NTDRIVERS_DATABASE_VERSION NTDRIVERS_DATABASE_VERSION_3
44 /* Map generic permissions to printer object specific permissions */
46 GENERIC_MAPPING printer_generic_mapping = {
47 PRINTER_READ,
48 PRINTER_WRITE,
49 PRINTER_EXECUTE,
50 PRINTER_ALL_ACCESS
51 };
53 STANDARD_MAPPING printer_std_mapping = {
54 PRINTER_READ,
55 PRINTER_WRITE,
56 PRINTER_EXECUTE,
57 PRINTER_ALL_ACCESS
58 };
60 /* Map generic permissions to print server object specific permissions */
62 GENERIC_MAPPING printserver_generic_mapping = {
63 SERVER_READ,
64 SERVER_WRITE,
65 SERVER_EXECUTE,
66 SERVER_ALL_ACCESS
67 };
69 STANDARD_MAPPING printserver_std_mapping = {
70 SERVER_READ,
71 SERVER_WRITE,
72 SERVER_EXECUTE,
73 SERVER_ALL_ACCESS
74 };
76 /* We need one default form to support our default printer. Msoft adds the
77 forms it wants and in the ORDER it wants them (note: DEVMODE papersize is an
78 array index). Letter is always first, so (for the current code) additions
79 always put things in the correct order. */
199 };
205 };
221 };
224 {
240 }
243 DEBUG(0,("upgrade_to_version_3: failed to delete form. Error (%s)\n", tdb_errorstr(tdb_drivers)));
245 }
246 }
252 DEBUG(0,("upgrade_to_version_3: failed to move printer. Error (%s)\n", tdb_errorstr(tdb_printers)));
254 }
257 DEBUG(0,("upgrade_to_version_3: failed to delete printer. Error (%s)\n", tdb_errorstr(tdb_drivers)));
259 }
260 }
266 DEBUG(0,("upgrade_to_version_3: failed to move secdesc. Error (%s)\n", tdb_errorstr(tdb_printers)));
268 }
271 DEBUG(0,("upgrade_to_version_3: failed to delete secdesc. Error (%s)\n", tdb_errorstr(tdb_drivers)));
273 }
274 }
277 }
280 }
282 /****************************************************************************
283 Open the NT printing tdbs. Done once before fork().
284 ****************************************************************************/
287 {
301 }
310 }
319 }
323 /* handle a Samba upgrade */
325 {
326 int32 vers_id;
328 /* Cope with byte-reversed older versions of the db. */
330 if ((vers_id == NTDRIVERS_DATABASE_VERSION_2) || (IREV(vers_id) == NTDRIVERS_DATABASE_VERSION_2)) {
331 /* Written on a bigendian machine with old fetch_int code. Save as le. */
332 /* The only upgrade between V2 and V3 is to save the version in little-endian. */
335 }
339 if ((vers_id == NTDRIVERS_DATABASE_VERSION_1) || (IREV(vers_id) == NTDRIVERS_DATABASE_VERSION_1)) {
346 }
347 }
352 /*
353 * register callback to handle updating printers as new
354 * drivers are installed
355 */
359 /*
360 * register callback to handle updating printer data
361 * when a driver is initialized
362 */
368 }
370 /*******************************************************************
371 Function to allow filename parsing "the old way".
372 ********************************************************************/
376 {
381 }
383 /*******************************************************************
384 tdb traversal function for counting printers.
385 ********************************************************************/
389 {
394 DEBUG(10,("traverse_counting_printers: printer = [%s] printer_count = %d\n", key.dptr, *printer_count));
395 }
398 }
400 /*******************************************************************
401 Update the spooler global c_setprinter. This variable is initialized
402 when the parent smbd starts with the number of existing printers. It
403 is monotonically increased by the current number of printers *after*
404 each add or delete printer RPC. Only Microsoft knows why... JRR020119
405 ********************************************************************/
408 {
409 int32 c_setprinter;
414 /* Traverse the tdb, counting the printers */
417 /* If initializing, set c_setprinter to current printers count
418 * otherwise, bump it by the current printer count
419 */
422 else
431 }
433 /*******************************************************************
434 Get the spooler global c_setprinter, accounting for initialization.
435 ********************************************************************/
438 {
447 }
449 /****************************************************************************
450 Get builtin form struct list.
451 ****************************************************************************/
454 {
457 }
459 /****************************************************************************
460 get a builtin form struct
461 ****************************************************************************/
464 {
466 fstring form_name;
475 }
476 }
479 }
481 /****************************************************************************
482 get a form struct list
483 ****************************************************************************/
485 {
488 nt_forms_struct form;
496 {
516 }
519 n++;
520 }
524 }
526 /****************************************************************************
527 write a form struct list
528 ****************************************************************************/
530 {
537 /* save index, so list is rebuilt in correct order */
549 }
552 }
554 /****************************************************************************
555 add a form struct at the end of the list
556 ****************************************************************************/
558 {
560 BOOL update;
561 fstring form_name;
564 /*
565 * NT tries to add forms even when
566 * they are already in the base
567 * only update the values if already present
568 */
578 }
579 }
585 }
589 }
600 }
602 /****************************************************************************
603 Delete a named form struct.
604 ****************************************************************************/
607 {
608 pstring key;
609 TDB_DATA kbuf;
611 fstring form_name;
621 }
622 }
628 }
636 }
639 }
641 /****************************************************************************
642 Update a form struct.
643 ****************************************************************************/
646 {
648 fstring form_name;
656 }
667 }
669 /****************************************************************************
670 Get the nt drivers list.
671 Traverse the database and look-up the matching names.
672 ****************************************************************************/
674 {
678 pstring key;
694 }
698 total++;
699 }
702 }
704 /****************************************************************************
705 function to do the mapping between the long architecture name and
706 the short one.
707 ****************************************************************************/
709 {
714 i++;
721 }
723 /* this might be client code - but shouldn't this be an fstrcpy etc? */
731 }
733 /****************************************************************************
734 Version information in Microsoft files is held in a VS_VERSION_INFO structure.
735 There are two case to be covered here: PE (Portable Executable) and NE (New
736 Executable) files. Both files support the same INFO structure, but PE files
737 store the signature in unicode, and NE files store it as !unicode.
738 returns -1 on error, 1 on version info found, and 0 on no version info found.
739 ****************************************************************************/
742 {
745 ssize_t byte_count;
751 }
753 /* Note: DOS_HEADER_SIZE < malloc'ed PE_HEADER_SIZE */
758 }
760 /* Is this really a DOS header? */
765 }
767 /* Skip OEM header (if any) and the DOS stub to start of Windows header */
768 if (SMB_VFS_LSEEK(fsp, fsp->fd, SVAL(buf,DOS_HEADER_LFANEW_OFFSET), SEEK_SET) == (SMB_OFF_T)-1) {
771 /* Assume this isn't an error... the file just looks sort of like a PE/NE file */
773 }
778 /* Assume this isn't an error... the file just looks sort of like a PE/NE file */
780 }
782 /* The header may be a PE (Portable Executable) or an NE (New Executable) */
790 /* At this point, we assume the file is in error. It still could be somthing
791 * else besides a PE file, but it unlikely at this point.
792 */
794 }
796 /* get the section table */
807 }
813 }
815 /* Iterate the section table looking for the resource section ".rsrc" */
831 }
833 /* Seek to the start of the .rsrc section info */
838 }
844 }
850 /* Scan for 1st 3 unicoded bytes followed by word aligned magic value */
852 /* Align to next long address */
865 }
866 }
867 }
868 }
869 }
871 /* Version info not found, fall back to origin date/time */
880 /* At this point, we assume the file is in error. It still could be somthing
881 * else besides a NE file, but it unlikely at this point. */
883 }
885 /* Allocate a bit more space to speed up things */
891 }
893 /* This is a HACK! I got tired of trying to sort through the messy
894 * 'NE' file format. If anyone wants to clean this up please have at
895 * it, but this works. 'NE' files will eventually fade away. JRR */
897 /* Cover case that should not occur in a well formed 'NE' .dll file */
901 /* Fast skip past data that can't possibly match */
904 /* Potential match data crosses buf boundry, move it to beginning
905 * of buf, and fill the buf with as much as it will hold. */
916 }
922 }
924 /* Check that the full signature string and the magic number that
925 * follows exist (not a perfect solution, but the chances that this
926 * occurs in code is, well, remote. Yes I know I'm comparing the 'V'
927 * twice, as it is simpler to read the code. */
929 /* Compute skip alignment to next long address */
942 }
943 }
944 }
946 /* Version info not found, fall back to origin date/time */
952 /* Assume this isn't an error... the file just looks sort of like a PE/NE file */
956 no_version_info:
960 error_exit:
963 }
965 /****************************************************************************
966 Drivers for Microsoft systems contain multiple files. Often, multiple drivers
967 share one or more files. During the MS installation process files are checked
968 to insure that only a newer version of a shared file is installed over an
969 older version. There are several possibilities for this comparison. If there
970 is no previous version, the new one is newer (obviously). If either file is
971 missing the version info structure, compare the creation date (on Unix use
972 the modification date). Otherwise chose the numerically larger version number.
973 ****************************************************************************/
976 {
978 pstring filepath;
980 uint32 new_major;
981 uint32 new_minor;
984 uint32 old_major;
985 uint32 old_minor;
991 SMB_STRUCT_STAT st;
992 SMB_STRUCT_STAT stat_buf;
993 BOOL bad_path;
1000 /* Get file version info (if available) for previous file (if it exists) */
1010 /* Old file not found, so by definition new file is in fact newer */
1021 old_file));
1026 }
1027 }
1030 /* Get file version info (if available) for new file */
1039 /* New file not found, this shouldn't occur if the caller did its job */
1050 new_file));
1055 }
1056 }
1060 /* Compare versions and choose the larger version number */
1066 }
1070 }
1073 /* Compare modification time/dates and choose the newest time/date */
1077 }
1081 }
1082 }
1084 error_exit:
1088 }
1090 /****************************************************************************
1091 Determine the correct cVersion associated with an architecture and driver
1092 ****************************************************************************/
1095 {
1099 NTSTATUS nt_status;
1100 pstring driverpath;
1101 DATA_BLOB null_pw;
1102 fstring res_type;
1104 BOOL bad_path;
1105 SMB_STRUCT_STAT st;
1112 /* If architecture is Windows 95/98/ME, the version is always 0. */
1117 }
1119 /*
1120 * Connect to the print$ share under the same account as the user connected
1121 * to the rpc pipe. Note we must still be root to do this.
1122 */
1124 /* Null password is ok - we are already an authenticated user... */
1135 }
1137 /* We are temporarily becoming the connection user. */
1142 }
1144 /* Open the driver file (Portable Executable format) and determine the
1145 * deriver the cversion. */
1159 }
1161 uint32 major;
1162 uint32 minor;
1169 }
1171 /*
1172 * This is a Microsoft'ism. See references in MSDN to VER_FILEVERSION
1173 * for more details. Version in this case is not just the version of the
1174 * file, but the version in the sense of kernal mode (2) vs. user mode
1175 * (3) drivers. Other bits of the version fields are the version info.
1176 * JRR 010716
1177 */
1188 }
1192 }
1204 error_exit:
1212 }
1214 /****************************************************************************
1215 ****************************************************************************/
1218 {
1220 fstring new_name;
1223 WERROR err;
1225 /* clean up the driver name.
1226 * we can get .\driver.dll
1227 * or worse c:\windows\system\driver.dll !
1228 */
1229 /* using an intermediate string to not have overlaping memcpy()'s */
1233 }
1238 }
1243 }
1248 }
1255 }
1256 }
1257 }
1261 /* jfm:7/16/2000 the client always sends the cversion=0.
1262 * The server should check which version the driver is by reading
1263 * the PE header of driver->driverpath.
1264 *
1265 * For Windows 95/98 the version is 0 (so the value sent is correct)
1266 * For Windows NT (the architecture doesn't matter)
1267 * NT 3.1: cversion=0
1268 * NT 3.5/3.51: cversion=1
1269 * NT 4: cversion=2
1270 * NT2K: cversion=3
1271 */
1277 }
1279 /****************************************************************************
1280 ****************************************************************************/
1281 static WERROR clean_up_driver_struct_level_6(NT_PRINTER_DRIVER_INFO_LEVEL_6 *driver, struct current_user *user)
1282 {
1284 fstring new_name;
1287 WERROR err;
1289 /* clean up the driver name.
1290 * we can get .\driver.dll
1291 * or worse c:\windows\system\driver.dll !
1292 */
1293 /* using an intermediate string to not have overlaping memcpy()'s */
1297 }
1302 }
1307 }
1312 }
1319 }
1320 }
1321 }
1325 /* jfm:7/16/2000 the client always sends the cversion=0.
1326 * The server should check which version the driver is by reading
1327 * the PE header of driver->driverpath.
1328 *
1329 * For Windows 95/98 the version is 0 (so the value sent is correct)
1330 * For Windows NT (the architecture doesn't matter)
1331 * NT 3.1: cversion=0
1332 * NT 3.5/3.51: cversion=1
1333 * NT 4: cversion=2
1334 * NT2K: cversion=3
1335 */
1336 if ((driver->version = get_correct_cversion(architecture, driver->driverpath, user, &err)) == -1)
1340 }
1342 /****************************************************************************
1343 ****************************************************************************/
1346 {
1349 {
1353 }
1355 {
1359 }
1362 }
1363 }
1365 /****************************************************************************
1366 This function sucks and should be replaced. JRA.
1367 ****************************************************************************/
1369 static void convert_level_6_to_level3(NT_PRINTER_DRIVER_INFO_LEVEL_3 *dst, NT_PRINTER_DRIVER_INFO_LEVEL_6 *src)
1370 {
1382 }
1393 else
1395 }
1398 }
1400 #endif
1402 /****************************************************************************
1403 ****************************************************************************/
1406 {
1408 NT_PRINTER_DRIVER_INFO_LEVEL_3 converted_driver;
1410 pstring new_dir;
1411 pstring old_name;
1412 pstring new_name;
1413 DATA_BLOB null_pw;
1415 NTSTATUS nt_status;
1416 pstring inbuf;
1417 pstring outbuf;
1418 fstring res_type;
1419 BOOL bad_path;
1420 SMB_STRUCT_STAT st;
1436 }
1440 /*
1441 * Connect to the print$ share under the same account as the user connected to the rpc pipe.
1442 * Note we must be root to do this.
1443 */
1455 }
1457 /*
1458 * Save who we are - we are temporarily becoming the connection user.
1459 */
1464 }
1466 /*
1467 * make the directories version and version\driver_name
1468 * under the architecture directory.
1469 */
1475 /* For each driver file, archi\filexxx.yyy, if there is a duplicate file
1476 * listed for this driver which has already been moved, skip it (note:
1477 * drivers may list the same file name several times. Then check if the
1478 * file already exists in archi\cversion\, if so, check that the version
1479 * info (or time stamps if version info is unavailable) is newer (or the
1480 * date is later). If it is, move it to archi\cversion\filexxx.yyy.
1481 * Otherwise, delete the file.
1482 *
1483 * If a file is not moved to archi\cversion\ because of an error, all the
1484 * rest of the 'unmoved' driver files are removed from archi\. If one or
1485 * more of the driver's files was already moved to archi\cversion\, it
1486 * potentially leaves the driver in a partially updated state. Version
1487 * trauma will most likely occur if an client attempts to use any printer
1488 * bound to the driver. Perhaps a rewrite to make sure the moves can be
1489 * done is appropriate... later JRR
1490 */
1498 NTSTATUS status;
1507 }
1511 }
1512 }
1519 NTSTATUS status;
1528 }
1532 }
1533 }
1534 }
1542 NTSTATUS status;
1551 }
1555 }
1556 }
1557 }
1566 NTSTATUS status;
1575 }
1579 }
1580 }
1581 }
1593 }
1594 }
1599 NTSTATUS status;
1608 }
1612 }
1613 }
1614 NextDriver: ;
1615 }
1616 }
1622 }
1624 /****************************************************************************
1625 ****************************************************************************/
1627 {
1630 pstring directory;
1631 fstring temp_name;
1632 pstring key;
1639 /* The names are relative. We store them in the form: \print$\arch\version\driver.xxx
1640 * \\server is added in the rpc server layer.
1641 * It does make sense to NOT store the server's name in the printer TDB.
1642 */
1644 slprintf(directory, sizeof(directory)-1, "\\print$\\%s\\%d\\", architecture, driver->cversion);
1646 /* .inf files do not always list a file for each of the four standard files.
1647 * Don't prepend a path to a null filename, or client claims:
1648 * "The server on which the printer resides does not have a suitable
1649 * <printer driver name> printer driver installed. Click OK if you
1650 * wish to install the driver on your local machine."
1651 */
1655 }
1660 }
1665 }
1670 }
1675 slprintf(driver->dependentfiles[i], sizeof(driver->dependentfiles[i])-1, "%s%s", directory, temp_name);
1676 }
1677 }
1679 slprintf(key, sizeof(key)-1, "%s%s/%d/%s", DRIVERS_PREFIX, architecture, driver->cversion, driver->name);
1686 again:
1703 }
1704 }
1714 }
1718 }
1728 done:
1734 }
1736 /****************************************************************************
1737 ****************************************************************************/
1739 {
1740 NT_PRINTER_DRIVER_INFO_LEVEL_3 info3;
1755 }
1758 /****************************************************************************
1759 ****************************************************************************/
1760 static WERROR get_a_printer_driver_3_default(NT_PRINTER_DRIVER_INFO_LEVEL_3 **info_ptr, const char *driver, const char *arch)
1761 {
1762 NT_PRINTER_DRIVER_INFO_LEVEL_3 info;
1783 }
1785 /****************************************************************************
1786 ****************************************************************************/
1787 static WERROR get_a_printer_driver_3(NT_PRINTER_DRIVER_INFO_LEVEL_3 **info_ptr, fstring drivername, const char *arch, uint32 version)
1788 {
1789 NT_PRINTER_DRIVER_INFO_LEVEL_3 driver;
1794 pstring key;
1800 /* Windows 4.0 (i.e. win9x) should always use a version of 0 */
1805 DEBUG(8,("get_a_printer_driver_3: [%s%s/%d/%s]\n", DRIVERS_PREFIX, architecture, version, drivername));
1836 }
1841 i++;
1842 }
1853 }
1858 }
1860 /****************************************************************************
1861 Debugging function, dump at level 6 the struct in the logs.
1862 ****************************************************************************/
1865 {
1866 uint32 result;
1873 {
1875 {
1895 }
1897 }
1899 }
1904 }
1907 }
1909 /****************************************************************************
1910 ****************************************************************************/
1912 {
1964 }
1969 }
1971 /****************************************************************************
1972 Pack all values in all printer keys
1973 ***************************************************************************/
1976 {
1981 pstring path;
1987 /* loop over all keys */
1993 /* loop over all values */
1996 /* pathname should be stored as <key>\<value> */
2004 val,
2005 path,
2009 }
2011 }
2013 /* terminator */
2018 }
2021 /****************************************************************************
2022 Delete a printer - this just deletes the printer info file, any open
2023 handles are not affected.
2024 ****************************************************************************/
2027 {
2028 pstring key;
2029 TDB_DATA kbuf;
2038 }
2040 /* FIXME!!! Reorder so this forward declaration is not necessary --jerry */
2043 /****************************************************************************
2044 ****************************************************************************/
2046 {
2047 pstring key;
2050 WERROR ret;
2053 /*
2054 * in addprinter: no servername and the printer is the name
2055 * in setprinter: servername is \\server
2056 * and printer is \\server\\printer
2057 *
2058 * Samba manages only local printers.
2059 * we currently don't support things like path=\\other_server\printer
2060 */
2066 }
2068 /*
2069 * JFM: one day I'll forget.
2070 * below that's info->portname because that's the SAMBA sharename
2071 * and I made NT 'thinks' it's the portname
2072 * the info->sharename is the thing you can name when you add a printer
2073 * that's the short-name when you create shared printer for 95/98
2074 * So I've made a limitation in SAMBA: you can only have 1 printer model
2075 * behind a SAMBA share.
2076 */
2081 again:
2119 }
2123 }
2135 done:
2145 }
2148 /****************************************************************************
2149 Malloc and return an NT devicemode.
2150 ****************************************************************************/
2153 {
2161 }
2195 /* non utilisés par un driver d'imprimante */
2209 }
2211 /****************************************************************************
2212 Deepcopy an NT devicemode.
2213 ****************************************************************************/
2216 {
2222 if ((new_nt_devicemode = (NT_DEVICEMODE *)memdup(nt_devicemode, sizeof(NT_DEVICEMODE))) == NULL) {
2225 }
2229 if ((new_nt_devicemode->private = memdup(nt_devicemode->private, nt_devicemode->driverextra)) == NULL) {
2233 }
2234 }
2237 }
2239 /****************************************************************************
2240 Clean up and deallocate a (maybe partially) allocated NT_DEVICEMODE.
2241 ****************************************************************************/
2244 {
2254 }
2256 /****************************************************************************
2257 Clean up and deallocate a (maybe partially) allocated NT_PRINTER_INFO_LEVEL_2.
2258 ****************************************************************************/
2260 {
2272 /* clean up all registry keys */
2278 }
2281 /* finally the top level structure */
2284 }
2287 /****************************************************************************
2288 ****************************************************************************/
2290 {
2293 NT_DEVICEMODE devmode;
2341 /* the len in tdb_unpack is an int value and
2342 * devmode.driverextra is only a short
2343 */
2347 /* check to catch an invalid TDB entry so we don't segfault */
2350 }
2351 }
2360 }
2362 /****************************************************************************
2363 Allocate and initialize a new slot.
2364 ***************************************************************************/
2367 {
2374 /* allocate another slot in the NT_PRINTER_KEY array */
2382 /* initialze new key */
2394 }
2396 /****************************************************************************
2397 search for a registry key name in the existing printer data
2398 ***************************************************************************/
2401 {
2410 /* loop over all existing keys */
2418 }
2419 }
2422 }
2424 /****************************************************************************
2425 ***************************************************************************/
2428 {
2434 fstring subkeyname;
2441 /* match sure it is a subkey and not the key itself */
2447 /* get subkey path */
2451 p++;
2456 /* don't add a key more than once */
2461 }
2466 /* found a match, so allocate space and copy the name */
2473 }
2477 num_subkeys++;
2478 }
2480 }
2482 /* tag of the end */
2490 }
2492 #ifdef HAVE_ADS
2495 {
2504 }
2507 uint32 dword)
2508 {
2512 }
2515 BOOL b)
2516 {
2521 }
2525 {
2529 /* a multi-sz has to have a null string terminator, i.e., the last
2530 string must be followed by two nulls */
2542 }
2544 /****************************************************************************
2545 * Map the NT_PRINTER_INFO_LEVEL_2 data into DsSpooler keys for publishing.
2546 *
2547 * @param info2 NT_PRINTER_INFO_LEVEL_2 describing printer - gets modified
2548 * @return BOOL indicating success or failure
2549 ***************************************************************************/
2552 {
2554 fstring longname;
2585 PRINTER_ATTRIBUTE_KEEPPRINTEDJOBS));
2599 }
2603 }
2607 {
2611 /* find the DsSpooler key */
2619 }
2622 {
2623 ADS_STATUS ads_rc;
2635 /* set the DsSpooler info and attributes */
2644 }
2646 /* Build the ads mods */
2652 /* initial ads structure */
2658 }
2664 /* ads_connect() will find the DC for us */
2670 }
2672 /* figure out where to publish */
2675 /* We use ldap_get_dn here as we need the answer
2676 * in utf8 to call ldap_explode_dn(). JRA. */
2682 }
2689 }
2690 /* Now convert to CH_UNIX. */
2696 }
2703 }
2714 /* publish it */
2719 /* retreive the guid and store it locally */
2725 }
2731 }
2734 {
2735 ADS_STATUS ads_rc;
2739 WERROR win_rc;
2747 }
2753 }
2759 /* ads_connect() will find the DC for us */
2765 }
2767 /* remove the printer from the directory */
2775 }
2779 }
2781 /****************************************************************************
2782 * Publish a printer in the directory
2783 *
2784 * @param snum describing printer service
2785 * @return WERROR indicating status of publishing
2786 ***************************************************************************/
2789 {
2791 WERROR win_rc;
2807 }
2812 }
2816 {
2820 WERROR win_rc;
2837 }
2841 }
2847 }
2849 #else
2851 {
2853 }
2856 {
2858 }
2859 #endif
2860 /****************************************************************************
2861 ***************************************************************************/
2864 {
2876 /* remove all keys */
2885 }
2894 }
2896 /* remove a specific key (and all subkeys) */
2906 /* mark the slot as empty */
2909 }
2910 }
2912 /* find the first empty slot */
2917 removed_keys++;
2919 }
2920 }
2923 /* nothing was removed */
2926 /* move everything down */
2932 empty_slot++;
2933 removed_keys++;
2934 }
2935 }
2937 /* update count */
2941 /* sanity check to see if anything is left */
2948 }
2951 }
2953 /****************************************************************************
2954 ***************************************************************************/
2957 {
2961 /* we must have names on non-zero length */
2966 /* find the printer key first */
2972 /* make sure the value exists so we can return the correct error code */
2983 }
2985 /****************************************************************************
2986 ***************************************************************************/
2990 {
2994 /* we must have names on non-zero length */
2999 /* find the printer key first */
3015 }
3017 /****************************************************************************
3018 ***************************************************************************/
3020 REGISTRY_VALUE* get_printer_data( NT_PRINTER_INFO_LEVEL_2 *p2, const char *key, const char *value )
3021 {
3031 }
3033 /****************************************************************************
3034 Unpack a list of registry values frem the TDB
3035 ***************************************************************************/
3038 {
3040 uint32 type;
3048 /* add the "PrinterDriverData" key first for performance reasons */
3052 /* loop and unpack the rest of the registry values */
3056 /* check to see if there are any more registry values */
3063 /* unpack the next regval */
3066 string,
3071 /*
3072 * break of the keyname from the value name.
3073 * Should only be one '\' in the string returned.
3074 */
3078 /* Put in "PrinterDriverData" is no key specified */
3083 }
3088 }
3090 /* see if we need a new key */
3097 keyname));
3099 }
3101 /* add the new value */
3103 regval_ctr_addvalue( &printer_data->keys[key_index].values, valuename, type, (const char *)data_p, size );
3108 }
3111 }
3113 /****************************************************************************
3114 ***************************************************************************/
3117 {
3134 }
3140 }
3146 }
3160 nt_name++;
3165 {
3169 l--;
3170 }
3171 }
3174 os2_name++;
3176 {
3180 l--;
3181 }
3182 }
3191 }
3192 }
3195 }
3197 /****************************************************************************
3198 Get a default printer info 2 struct.
3199 ****************************************************************************/
3200 static WERROR get_a_printer_2_default(NT_PRINTER_INFO_LEVEL_2 **info_ptr, const char *sharename)
3201 {
3203 NT_PRINTER_INFO_LEVEL_2 info;
3215 /* by setting the driver name to an empty string, a local NT admin
3216 can now run the **local** APW to install a local printer driver
3217 for a Samba shared printer in 2.2. Without this, drivers **must** be
3218 installed on the Samba server for NT clients --jerry */
3222 #endif
3239 /*
3240 * I changed this as I think it is better to have a generic
3241 * DEVMODE than to crash Win2k explorer.exe --jerry
3242 * See the HP Deskjet 990c Win2k drivers for an example.
3243 *
3244 * However the default devmode appears to cause problems
3245 * with the HP CLJ 8500 PCL driver. Hence the addition of
3246 * the "default devmode" parameter --jerry 22/01/2002
3247 */
3252 }
3255 }
3257 /* This will get the current RPC talloc context, but we should be
3258 passing this as a parameter... fixme... JRA ! */
3267 }
3271 fail:
3275 }
3277 /****************************************************************************
3278 ****************************************************************************/
3280 {
3281 pstring key;
3282 NT_PRINTER_INFO_LEVEL_2 info;
3285 fstring printername;
3323 /* Samba has to have shared raw drivers. */
3326 /* Restore the stripped strings. */
3334 /*
3335 * Some client drivers freak out if there is a NULL devmode
3336 * (probably the driver is not checking before accessing
3337 * the devmode pointer) --jerry
3338 *
3339 * See comments in get_a_printer_2_default()
3340 */
3344 printername));
3346 }
3351 }
3355 /* This will get the current RPC talloc context, but we should be
3356 passing this as a parameter... fixme... JRA ! */
3360 /* Fix for OS/2 drivers. */
3372 }
3374 /****************************************************************************
3375 Debugging function, dump at level 6 the struct in the logs.
3376 ****************************************************************************/
3378 {
3379 uint32 result;
3386 {
3389 else
3390 {
3417 }
3419 }
3424 }
3427 }
3429 /****************************************************************************
3430 Update the changeid time.
3431 This is SO NASTY as some drivers need this to change, others need it
3432 static. This value will change every second, and I must hope that this
3433 is enough..... DON'T CHANGE THIS CODE WITHOUT A TEST MATRIX THE SIZE OF
3434 UTAH ! JRA.
3435 ****************************************************************************/
3438 {
3444 /* Return changeid as msec since spooler restart */
3446 #else
3447 /*
3448 * This setting seems to work well but is too untested
3449 * to replace the above calculation. Left in for experiementation
3450 * of the reader --jerry (Tue Mar 12 09:15:05 CST 2002)
3451 */
3453 #endif
3454 }
3456 /*
3457 * The function below are the high level ones.
3458 * only those ones must be called from the spoolss code.
3459 * JFM.
3460 */
3462 /****************************************************************************
3463 Modify a printer. This is called from SETPRINTERDATA/DELETEPRINTERDATA.
3464 ****************************************************************************/
3467 {
3468 WERROR result;
3472 /*
3473 * invalidate cache for all open handles to this printer.
3474 * cache for a given handle will be updated on the next
3475 * get_a_printer()
3476 */
3482 {
3483 /*
3484 * Update the changestamp. Emperical tests show that the
3485 * ChangeID is always updated,but c_setprinter is
3486 * global spooler variable (not per printer).
3487 */
3489 /* ChangeID **must** be increasing over the lifetime
3490 of client's spoolss service in order for the
3491 client's cache to show updates */
3495 /*
3496 * Because one day someone will ask:
3497 * NT->NT An admin connection to a remote
3498 * printer show changes imeediately in
3499 * the properities dialog
3500 *
3501 * A non-admin connection will only show the
3502 * changes after viewing the properites page
3503 * 2 times. Seems to be related to a
3504 * race condition in the client between the spooler
3505 * updating the local cache and the Explorer.exe GUI
3506 * actually displaying the properties.
3507 *
3508 * This is fixed in Win2k. admin/non-admin
3509 * connections both display changes immediately.
3510 *
3511 * 14/12/01 --jerry
3512 */
3517 }
3521 }
3524 }
3526 /****************************************************************************
3527 Initialize printer devmode & data with previously saved driver init values.
3528 ****************************************************************************/
3531 {
3533 pstring key;
3535 NT_PRINTER_INFO_LEVEL_2 info;
3540 /*
3541 * Delete any printer data 'values' already set. When called for driver
3542 * replace, there will generally be some, but during an add printer, there
3543 * should not be any (if there are delete them).
3544 */
3555 /*
3556 * When changing to a driver that has no init info in the tdb, remove
3557 * the previous drivers init info and leave the new on blank.
3558 */
3561 }
3563 /*
3564 * Get the saved DEVMODE..
3565 */
3569 /*
3570 * The saved DEVMODE contains the devicename from the printer used during
3571 * the initialization save. Change it to reflect the new printer.
3572 */
3577 }
3579 /*
3580 * NT/2k does not change out the entire DeviceMode of a printer
3581 * when changing the driver. Only the driverextra, private, &
3582 * driverversion fields. --jerry (Thu Mar 14 08:58:43 CST 2002)
3583 *
3584 * Later examination revealed that Windows NT/2k does reset the
3585 * the printer's device mode, bit **only** when you change a
3586 * property of the device mode such as the page orientation.
3587 * --jerry
3588 */
3591 /* Bind the saved DEVMODE to the new the printer */
3599 /* Add the printer data 'values' to the new printer */
3607 }
3609 /****************************************************************************
3610 Initialize printer devmode & data with previously saved driver init values.
3611 When a printer is created using AddPrinter, the drivername bound to the
3612 printer is used to lookup previously saved driver initialization info, which
3613 is bound to the new printer.
3614 ****************************************************************************/
3617 {
3627 level));
3629 }
3632 }
3634 /****************************************************************************
3635 Delete driver init data stored for a specified driver
3636 ****************************************************************************/
3639 {
3640 pstring key;
3641 TDB_DATA kbuf;
3646 }
3656 }
3658 /****************************************************************************
3659 Pack up the DEVMODE and values for a printer into a 'driver init' entry
3660 in the tdb. Note: this is different from the driver entry and the printer
3661 entry. There should be a single driver init entry for each driver regardless
3662 of whether it was installed from NT or 2K. Technically, they should be
3663 different, but they work out to the same struct.
3664 ****************************************************************************/
3667 {
3668 pstring key;
3676 again:
3690 }
3691 else
3695 }
3706 done:
3716 }
3718 /****************************************************************************
3719 Update (i.e. save) the driver init info (DEVMODE and values) for a printer
3720 ****************************************************************************/
3723 {
3724 uint32 result;
3735 }
3738 }
3740 /****************************************************************************
3741 Convert the printer data value, a REG_BINARY array, into an initialization
3742 DEVMODE. Note: the array must be parsed as if it was a DEVMODE in an rpc...
3743 got to keep the endians happy :).
3744 ****************************************************************************/
3746 static BOOL convert_driver_init( TALLOC_CTX *ctx, NT_DEVICEMODE *nt_devmode, uint8 *data, uint32 data_len )
3747 {
3749 prs_struct ps;
3750 DEVICEMODE devmode;
3760 else
3764 }
3766 /****************************************************************************
3767 Set the DRIVER_INIT info in the tdb. Requires Win32 client code that:
3769 1. Use the driver's config DLL to this UNC printername and:
3770 a. Call DrvPrintEvent with PRINTER_EVENT_INITIALIZE
3771 b. Call DrvConvertDevMode with CDM_DRIVER_DEFAULT to get default DEVMODE
3772 2. Call SetPrinterData with the 'magic' key and the DEVMODE as data.
3774 The last step triggers saving the "driver initialization" information for
3775 this printer into the tdb. Later, new printers that use this driver will
3776 have this initialization information bound to them. This simulates the
3777 driver initialization, as if it had run on the Samba server (as it would
3778 have done on NT).
3780 The Win32 client side code requirement sucks! But until we can run arbitrary
3781 Win32 printer driver code on any Unix that Samba runs on, we are stuck with it.
3783 It would have been easier to use SetPrinter because all the UNMARSHALLING of
3784 the DEVMODE is done there, but 2K/XP clients do not set the DEVMODE... think
3785 about it and you will realize why. JRR 010720
3786 ****************************************************************************/
3788 static WERROR save_driver_init_2(NT_PRINTER_INFO_LEVEL *printer, uint8 *data, uint32 data_len )
3789 {
3795 /*
3796 * When the DEVMODE is already set on the printer, don't try to unpack it.
3797 */
3801 /*
3802 * Set devmode on printer info, so entire printer initialization can be
3803 * saved to tdb.
3804 */
3812 }
3816 /*
3817 * The DEVMODE is held in the 'data' component of the param in raw binary.
3818 * Convert it to to a devmode structure
3819 */
3824 }
3827 }
3829 /*
3830 * Pack up and add (or update) the DEVMODE and any current printer data to
3831 * a 'driver init' element in the tdb
3832 *
3833 */
3839 }
3841 /*
3842 * If driver initialization info was successfully saved, set the current
3843 * printer to match it. This allows initialization of the current printer
3844 * as well as the driver.
3845 */
3850 }
3852 done:
3859 }
3861 /****************************************************************************
3862 Update the driver init info (DEVMODE and specifics) for a printer
3863 ****************************************************************************/
3865 WERROR save_driver_init(NT_PRINTER_INFO_LEVEL *printer, uint32 level, uint8 *data, uint32 data_len)
3866 {
3876 }
3879 }
3881 /****************************************************************************
3882 Deep copy a NT_PRINTER_DATA
3883 ****************************************************************************/
3886 {
3895 /* create a new instance of the printerkey in the destination
3896 printer_data object */
3904 /* dup the printer entire printer key */
3908 }
3909 }
3912 }
3914 /****************************************************************************
3915 Deep copy a NT_PRINTER_INFO_LEVEL_2 structure using malloc()'d memeory
3916 Caller must free.
3917 ****************************************************************************/
3920 {
3931 /* malloc()'d members copied here */
3938 /* this is talloc()'d; very ugly that we have a structure that
3939 is half malloc()'d and half talloc()'d but that is the way
3940 that the PRINTER_INFO stuff is written right now. --jerry */
3945 }
3947 /****************************************************************************
3948 Get a NT_PRINTER_INFO_LEVEL struct. It returns malloced memory.
3950 Previously the code had a memory allocation problem because it always
3951 used the TALLOC_CTX from the Printer_entry*. This context lasts
3952 as a long as the original handle is open. So if the client made a lot
3953 of getprinter[data]() calls, the memory usage would climb. Now we use
3954 a short lived TALLOC_CTX for printer_info_2 objects returned. We
3955 still use the Printer_entry->ctx for maintaining the cache copy though
3956 since that object must live as long as the handle by definition.
3957 --jerry
3959 ****************************************************************************/
3961 WERROR get_a_printer( Printer_entry *print_hnd, NT_PRINTER_INFO_LEVEL **pp_printer, uint32 level,
3963 {
3964 WERROR result;
3976 }
3979 /*
3980 * check for cache first. A Printer handle cannot changed
3981 * to another printer object so we only check that the printer
3982 * is actually for a printer and that the printer_info pointer
3983 * is valid
3984 */
3988 {
3989 /* get_talloc_ctx() works here because we need a short
3990 lived talloc context */
3993 {
3998 }
4006 }
4008 /* no cache for this handle; see if we can match one from another handle.
4009 Make sure to use a short lived talloc ctx */
4014 /* fail to disk if we don't have it with any open handle */
4019 /* we have a new printer now. Save it with this handle */
4024 /* save a copy in cache */
4030 /* make sure to use the handle's talloc ctx here since
4031 the printer_2 object must last until the handle is closed */
4035 /* don't fail the lookup just because the cache update failed */
4038 }
4039 }
4041 }
4042 else
4050 }
4052 DEBUG(10,("get_a_printer: [%s] level %u returning %s\n", sharename, (unsigned int)level, dos_errstr(result)));
4055 }
4057 /****************************************************************************
4058 Deletes a NT_PRINTER_INFO_LEVEL struct.
4059 ****************************************************************************/
4062 {
4063 uint32 result;
4083 }
4087 }
4089 /****************************************************************************
4090 ****************************************************************************/
4092 {
4093 uint32 result;
4109 }
4112 }
4113 /****************************************************************************
4114 ****************************************************************************/
4118 {
4119 WERROR result;
4123 /* Sometime we just want any version of the driver */
4126 /* look for Win2k first and then for NT4 */
4133 }
4137 }
4143 }
4149 }
4151 /****************************************************************************
4152 ****************************************************************************/
4154 {
4155 uint32 result;
4159 {
4162 {
4170 }
4172 }
4174 {
4185 }
4187 }
4191 }
4193 }
4196 /****************************************************************************
4197 Determine whether or not a particular driver is currently assigned
4198 to a printer
4199 ****************************************************************************/
4202 {
4212 /* loop through the printers.tdb and check for the drivername */
4224 }
4227 }
4231 /* report that the driver is not in use by default */
4234 }
4237 /**********************************************************************
4238 Check to see if a ogiven file is in use by *info
4239 *********************************************************************/
4242 {
4260 /* see of there are any dependent files to examine */
4268 i++;
4269 }
4273 }
4275 /**********************************************************************
4276 Utility function to remove the dependent file pointed to by the
4277 input parameter from the list
4278 *********************************************************************/
4281 {
4283 /* bump everything down a slot */
4287 idx++;
4288 }
4293 }
4295 /**********************************************************************
4296 Check if any of the files used by src are also used by drv
4297 *********************************************************************/
4301 {
4308 /* check each file. Remove it from the src structure if it overlaps */
4314 }
4320 }
4326 }
4332 }
4334 /* are there any dependentfiles to examine? */
4345 i++;
4346 }
4349 }
4351 /****************************************************************************
4352 Determine whether or not a particular driver files are currently being
4353 used by any other driver.
4355 Return value is True if any files were in use by other drivers
4356 and False otherwise.
4358 Upon return, *info has been modified to only contain the driver files
4359 which are not in use
4360 ****************************************************************************/
4363 {
4366 uint32 version;
4368 NT_PRINTER_DRIVER_INFO_LEVEL driver;
4375 /* loop over all driver versions */
4379 /* get the list of drivers */
4387 /* check each driver for overlap in files */
4397 }
4399 /* check if d2 uses any files from d1 */
4400 /* only if this is a different driver than the one being deleted */
4407 }
4408 }
4411 }
4423 }
4425 /****************************************************************************
4426 Actually delete the driver files. Make sure that
4427 printer_driver_files_in_use() return False before calling
4428 this.
4429 ****************************************************************************/
4431 static BOOL delete_driver_files( NT_PRINTER_DRIVER_INFO_LEVEL_3 *info_3, struct current_user *user )
4432 {
4436 DATA_BLOB null_pw;
4437 NTSTATUS nt_status;
4438 fstring res_type;
4439 BOOL bad_path;
4440 SMB_STRUCT_STAT st;
4445 DEBUG(6,("delete_driver_files: deleting driver [%s] - version [%d]\n", info_3->name, info_3->cversion));
4447 /*
4448 * Connect to the print$ share under the same account as the
4449 * user connected to the rpc pipe. Note we must be root to
4450 * do this.
4451 */
4462 }
4464 /* Save who we are - we are temporarily becoming the connection user. */
4469 }
4471 /* now delete the files; must strip the '\print$' string from
4472 fron of path */
4479 }
4480 }
4487 }
4488 }
4495 }
4496 }
4503 }
4504 }
4506 /* check if we are done removing files */
4512 /* bypass the "\print$" portion of the path */
4518 }
4520 i++;
4521 }
4522 }
4527 }
4529 /****************************************************************************
4530 Remove a printer driver from the TDB. This assumes that the the driver was
4531 previously looked up.
4532 ***************************************************************************/
4534 WERROR delete_printer_driver( NT_PRINTER_DRIVER_INFO_LEVEL_3 *info_3, struct current_user *user,
4536 {
4537 pstring key;
4540 NT_PRINTER_DRIVER_INFO_LEVEL ctr;
4542 /* delete the tdb data first */
4557 /* check if the driver actually exists for this environment */
4563 }
4567 /* ok... the driver exists so the delete should return success */
4572 }
4574 /*
4575 * now delete any associated files if delete_files == True
4576 * even if this part failes, we return succes because the
4577 * driver doesn not exist any more
4578 */
4587 }
4589 /****************************************************************************
4590 Store a security desc for a printer.
4591 ****************************************************************************/
4594 {
4597 prs_struct ps;
4599 fstring key;
4600 WERROR status;
4606 /* The old owner and group sids of the security descriptor are not
4607 present when new ACEs are added or removed by changing printer
4608 permissions through NT. If they are NULL in the new security
4609 descriptor then copy them over from the old one. */
4619 /* Pick out correct owner and group sids */
4637 /* Make a deep copy of the security descriptor */
4641 sacl,
4642 dacl,
4646 }
4650 }
4652 /* Store the security descriptor in a tdb */
4661 }
4670 }
4672 /* Free malloc'ed memory */
4674 out:
4680 }
4682 /****************************************************************************
4683 Construct a default security descriptor buffer for a printer.
4684 ****************************************************************************/
4687 {
4689 SEC_ACCESS sa;
4693 DOM_SID owner_sid;
4696 /* Create an ACE where Everyone is allowed to print */
4702 /* Make the security descriptor owned by the Administrators group
4703 on the PDC of the domain. */
4709 /* Backup plan - make printer owned by admins.
4710 This should emulate a lanman printer as security
4711 settings can't be changed. */
4715 }
4720 SEC_ACE_FLAG_INHERIT_ONLY);
4726 /* The ACL revision number in rpc_secdesc.h differs from the one
4727 created by NT when setting ACE entries in printer
4728 descriptors. NT4 complains about the property being edited by a
4729 NT5 machine. */
4735 }
4740 }
4748 }
4750 /****************************************************************************
4751 Get a security desc for a printer.
4752 ****************************************************************************/
4755 {
4756 prs_struct ps;
4757 fstring key;
4762 }
4764 /* Fetch security descriptor from tdb */
4775 }
4777 /* Save default security descriptor for later */
4788 }
4790 /* If security descriptor is owned by S-1-1-0 and winbindd is up,
4791 this security descriptor has been created when winbindd was
4792 down. Take ownership of security descriptor. */
4795 DOM_SID owner_sid;
4797 /* Change sd owner to workgroup administrator */
4804 /* Create new sd */
4817 /* Swap with other one */
4821 /* Set it */
4824 }
4825 }
4835 fstring sid_str;
4842 }
4843 }
4847 }
4849 /* error code:
4850 0: everything OK
4851 1: level not implemented
4852 2: file doesn't exist
4853 3: can't allocate memory
4854 4: can't free memory
4855 5: non existant struct
4856 */
4858 /*
4859 A printer and a printer driver are 2 different things.
4860 NT manages them separatelly, Samba does the same.
4861 Why ? Simply because it's easier and it makes sense !
4863 Now explanation: You have 3 printers behind your samba server,
4864 2 of them are the same make and model (laser A and B). But laser B
4865 has an 3000 sheet feeder and laser A doesn't such an option.
4866 Your third printer is an old dot-matrix model for the accounting :-).
4868 If the /usr/local/samba/lib directory (default dir), you will have
4869 5 files to describe all of this.
4871 3 files for the printers (1 by printer):
4872 NTprinter_laser A
4873 NTprinter_laser B
4874 NTprinter_accounting
4875 2 files for the drivers (1 for the laser and 1 for the dot matrix)
4876 NTdriver_printer model X
4877 NTdriver_printer model Y
4879 jfm: I should use this comment for the text file to explain
4880 same thing for the forms BTW.
4881 Je devrais mettre mes commentaires en francais, ca serait mieux :-)
4883 */
4885 /* Convert generic access rights to printer object specific access rights.
4886 It turns out that NT4 security descriptors use generic access rights and
4887 NT5 the object specific ones. */
4890 {
4896 }
4897 }
4899 /****************************************************************************
4900 Check a user has permissions to perform the given operation. We use the
4901 permission constants defined in include/rpc_spoolss.h to check the various
4902 actions we perform when checking printer access.
4904 PRINTER_ACCESS_ADMINISTER:
4905 print_queue_pause, print_queue_resume, update_printer_sec,
4906 update_printer, spoolss_addprinterex_level_2,
4907 _spoolss_setprinterdata
4909 PRINTER_ACCESS_USE:
4910 print_job_start
4912 JOB_ACCESS_ADMINISTER:
4913 print_job_delete, print_job_pause, print_job_resume,
4914 print_queue_purge
4916 ****************************************************************************/
4918 {
4920 uint32 access_granted;
4921 NTSTATUS status;
4922 BOOL result;
4927 /* If user is NULL then use the current_user structure */
4932 /* Always allow root or printer admins to do anything */
4937 }
4939 /* Get printer name */
4946 }
4948 /* Get printer security descriptor */
4953 }
4960 /* Create a child security descriptor to check permissions
4961 against. This is because print jobs are child objects
4962 objects of a printer. */
4966 /* Now this is the bit that really confuses me. The access
4967 type needs to be changed from JOB_ACCESS_ADMINISTER to
4968 PRINTER_ACCESS_ADMINISTER for this to work. Something
4969 to do with the child (job) object becoming like a
4970 printer?? -tpot */
4973 }
4975 /* Check access */
4990 }
4992 /****************************************************************************
4993 Check the time parameters allow a print operation.
4994 *****************************************************************************/
4997 {
5002 uint32 mins;
5022 }