| blob | a8bc577370544e8ba42f9cb8bc381026f3893736 |
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-2005.
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 3 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, see <http://www.gnu.org/licenses/>.
20 */
37 #define NTDRIVERS_DATABASE_VERSION_1 1
38 #define NTDRIVERS_DATABASE_VERSION_2 2
43 /* Map generic permissions to printer object specific permissions */
46 PRINTER_READ,
47 PRINTER_WRITE,
48 PRINTER_EXECUTE,
49 PRINTER_ALL_ACCESS
50 };
53 PRINTER_READ,
54 PRINTER_WRITE,
55 PRINTER_EXECUTE,
56 PRINTER_ALL_ACCESS
57 };
59 /* Map generic permissions to print server object specific permissions */
62 SERVER_READ,
63 SERVER_WRITE,
64 SERVER_EXECUTE,
65 SERVER_ALL_ACCESS
66 };
69 SERVER_READ,
70 SERVER_WRITE,
71 SERVER_EXECUTE,
72 SERVER_ALL_ACCESS
73 };
75 /* Map generic permissions to job object specific permissions */
78 JOB_READ,
79 JOB_WRITE,
80 JOB_EXECUTE,
81 JOB_ALL_ACCESS
82 };
84 /* We need one default form to support our default printer. Msoft adds the
85 forms it wants and in the ORDER it wants them (note: DEVMODE papersize is an
86 array index). Letter is always first, so (for the current code) additions
87 always put things in the correct order. */
207 };
219 };
222 /****************************************************************************
223 generate a new TDB_DATA key for storing a printer
224 ****************************************************************************/
227 {
228 fstring share;
230 TDB_DATA key;
239 }
241 /****************************************************************************
242 generate a new TDB_DATA key for storing a printer security descriptor
243 ****************************************************************************/
247 {
248 fstring share;
250 TDB_DATA key;
259 }
261 /****************************************************************************
262 ****************************************************************************/
265 {
281 }
284 DEBUG(0,("upgrade_to_version_3: failed to delete form. Error (%s)\n", tdb_errorstr(tdb_drivers)));
286 }
287 }
293 DEBUG(0,("upgrade_to_version_3: failed to move printer. Error (%s)\n", tdb_errorstr(tdb_printers)));
295 }
298 DEBUG(0,("upgrade_to_version_3: failed to delete printer. Error (%s)\n", tdb_errorstr(tdb_drivers)));
300 }
301 }
307 DEBUG(0,("upgrade_to_version_3: failed to move secdesc. Error (%s)\n", tdb_errorstr(tdb_printers)));
309 }
312 DEBUG(0,("upgrade_to_version_3: failed to delete secdesc. Error (%s)\n", tdb_errorstr(tdb_drivers)));
314 }
315 }
318 }
321 }
323 /*******************************************************************
324 Fix an issue with security descriptors. Printer sec_desc must
325 use more than the generic bits that were previously used
326 in <= 3.0.14a. They must also have a owner and group SID assigned.
327 Otherwise, any printers than have been migrated to a Windows
328 host using printmig.exe will not be accessible.
329 *******************************************************************/
333 {
334 NTSTATUS status;
340 uint32 sd_size;
345 }
349 }
351 /* upgrade the security descriptor */
355 /* delete bad entries */
360 }
364 }
367 /* is this even valid? */
371 }
373 /* update access masks */
390 }
391 }
393 /* create a new SEC_DESC with the appropriate owner and group SIDs */
401 }
405 }
410 }
412 /* store it back */
421 }
425 /* 0 to continue and non-zero to stop traversal */
428 }
430 /*******************************************************************
431 *******************************************************************/
434 {
448 }
450 /*******************************************************************
451 Fix an issue with security descriptors. Printer sec_desc must
452 use more than the generic bits that were previously used
453 in <= 3.0.14a. They must also have a owner and group SID assigned.
454 Otherwise, any printers than have been migrated to a Windows
455 host using printmig.exe will not be accessible.
456 *******************************************************************/
460 {
462 TDB_DATA new_key;
467 /* upgrade printer records and security descriptors */
471 }
474 }
476 /* ignore this record */
478 }
480 /* delete the original record and store under the normalized key */
486 }
492 }
495 }
497 /*******************************************************************
498 *******************************************************************/
501 {
515 }
517 /****************************************************************************
518 Open the NT printing tdbs. Done once before fork().
519 ****************************************************************************/
522 {
524 WERROR win_rc;
525 int32 vers_id;
537 }
541 tdb_printers = tdb_open_log(state_path("ntprinters.tdb"), 0, TDB_DEFAULT, O_RDWR|O_CREAT, 0600);
546 }
555 }
557 /* handle a Samba upgrade */
564 }
568 if ((vers_id == NTDRIVERS_DATABASE_VERSION_1) || (IREV(vers_id) == NTDRIVERS_DATABASE_VERSION_1)) {
573 }
575 if ((vers_id == NTDRIVERS_DATABASE_VERSION_2) || (IREV(vers_id) == NTDRIVERS_DATABASE_VERSION_2)) {
576 /* Written on a bigendian machine with old fetch_int code. Save as le. */
577 /* The only upgrade between V2 and V3 is to save the version in little-endian. */
580 }
587 }
594 }
600 }
601 }
605 /*
606 * register callback to handle updating printers as new
607 * drivers are installed
608 */
611 do_drv_upgrade_printer);
613 /*
614 * register callback to handle updating printer data
615 * when a driver is initialized
616 */
619 reset_all_printerdata);
621 /* of course, none of the message callbacks matter if you don't
622 tell messages.c that you interested in receiving PRINT_GENERAL
623 msgs. This is done in serverid_register() */
630 }
633 }
635 /*******************************************************************
636 Function to allow filename parsing "the old way".
637 ********************************************************************/
642 {
643 NTSTATUS status;
649 }
654 }
660 }
663 }
665 /*******************************************************************
666 tdb traversal function for counting printers.
667 ********************************************************************/
671 {
676 DEBUG(10,("traverse_counting_printers: printer = [%s] printer_count = %d\n", key.dptr, *printer_count));
677 }
680 }
682 /*******************************************************************
683 Update the spooler global c_setprinter. This variable is initialized
684 when the parent smbd starts with the number of existing printers. It
685 is monotonically increased by the current number of printers *after*
686 each add or delete printer RPC. Only Microsoft knows why... JRR020119
687 ********************************************************************/
690 {
691 int32 c_setprinter;
696 /* Traverse the tdb, counting the printers */
699 /* If initializing, set c_setprinter to current printers count
700 * otherwise, bump it by the current printer count
701 */
704 else
713 }
715 /*******************************************************************
716 Get the spooler global c_setprinter, accounting for initialization.
717 ********************************************************************/
720 {
729 }
731 /****************************************************************************
732 Get builtin form struct list.
733 ****************************************************************************/
736 {
740 }
742 }
744 /****************************************************************************
745 get a builtin form struct
746 ****************************************************************************/
749 {
757 }
758 }
761 }
763 /****************************************************************************
764 get a form struct list.
765 ****************************************************************************/
768 {
770 nt_forms_struct form;
780 {
800 }
802 n++;
803 }
807 }
809 /****************************************************************************
810 write a form struct list
811 ****************************************************************************/
814 {
819 TDB_DATA dbuf;
823 /* save index, so list is rebuilt in correct order */
830 }
834 }
842 }
849 }
852 }
855 }
857 /****************************************************************************
858 add a form struct at the end of the list
859 ****************************************************************************/
861 {
865 /*
866 * NT tries to add forms even when
867 * they are already in the base
868 * only update the values if already present
869 */
877 }
878 }
884 }
887 }
901 }
903 /****************************************************************************
904 Delete a named form struct.
905 ****************************************************************************/
908 {
918 }
919 }
925 }
930 }
935 }
938 }
940 /****************************************************************************
941 Update a form struct.
942 ****************************************************************************/
945 {
953 }
964 }
966 /****************************************************************************
967 Get the nt drivers list.
968 Traverse the database and look-up the matching names.
969 ****************************************************************************/
971 {
980 }
985 }
998 }
1001 total++;
1002 }
1006 }
1008 /****************************************************************************
1009 Function to do the mapping between the long architecture name and
1010 the short one.
1011 ****************************************************************************/
1014 {
1019 i++;
1026 }
1028 /* this might be client code - but shouldn't this be an fstrcpy etc? */
1035 }
1037 /****************************************************************************
1038 Version information in Microsoft files is held in a VS_VERSION_INFO structure.
1039 There are two case to be covered here: PE (Portable Executable) and NE (New
1040 Executable) files. Both files support the same INFO structure, but PE files
1041 store the signature in unicode, and NE files store it as !unicode.
1042 returns -1 on error, 1 on version info found, and 0 on no version info found.
1043 ****************************************************************************/
1046 {
1049 ssize_t byte_count;
1055 }
1061 }
1063 /* Is this really a DOS header? */
1068 }
1070 /* Skip OEM header (if any) and the DOS stub to start of Windows header */
1074 /* Assume this isn't an error... the file just looks sort of like a PE/NE file */
1076 }
1078 /* Note: DOS_HEADER_SIZE and NE_HEADER_SIZE are incidentally same */
1082 /* Assume this isn't an error... the file just looks sort of like a PE/NE file */
1084 }
1086 /* The header may be a PE (Portable Executable) or an NE (New Executable) */
1091 /* Just skip over optional header to get to section table */
1098 }
1100 /* get the section table */
1111 }
1117 }
1119 /* Iterate the section table looking for the resource section ".rsrc" */
1135 }
1137 /* Seek to the start of the .rsrc section info */
1142 }
1148 }
1154 /* Scan for 1st 3 unicoded bytes followed by word aligned magic value */
1156 /* Align to next long address */
1169 }
1170 }
1171 }
1172 }
1173 }
1175 /* Version info not found, fall back to origin date/time */
1184 /* At this point, we assume the file is in error. It still could be somthing
1185 * else besides a NE file, but it unlikely at this point. */
1187 }
1189 /* Allocate a bit more space to speed up things */
1195 }
1197 /* This is a HACK! I got tired of trying to sort through the messy
1198 * 'NE' file format. If anyone wants to clean this up please have at
1199 * it, but this works. 'NE' files will eventually fade away. JRR */
1201 /* Cover case that should not occur in a well formed 'NE' .dll file */
1205 /* Fast skip past data that can't possibly match */
1208 /* Potential match data crosses buf boundry, move it to beginning
1209 * of buf, and fill the buf with as much as it will hold. */
1220 }
1226 }
1228 /* Check that the full signature string and the magic number that
1229 * follows exist (not a perfect solution, but the chances that this
1230 * occurs in code is, well, remote. Yes I know I'm comparing the 'V'
1231 * twice, as it is simpler to read the code. */
1233 /* Compute skip alignment to next long address */
1246 }
1247 }
1248 }
1250 /* Version info not found, fall back to origin date/time */
1256 /* Assume this isn't an error... the file just looks sort of like a PE/NE file */
1260 no_version_info:
1264 error_exit:
1267 }
1269 /****************************************************************************
1270 Drivers for Microsoft systems contain multiple files. Often, multiple drivers
1271 share one or more files. During the MS installation process files are checked
1272 to insure that only a newer version of a shared file is installed over an
1273 older version. There are several possibilities for this comparison. If there
1274 is no previous version, the new one is newer (obviously). If either file is
1275 missing the version info structure, compare the creation date (on Unix use
1276 the modification date). Otherwise chose the numerically larger version number.
1277 ****************************************************************************/
1280 {
1283 uint32 new_major;
1284 uint32 new_minor;
1287 uint32 old_major;
1288 uint32 old_minor;
1293 SMB_STRUCT_STAT st;
1295 NTSTATUS status;
1302 /* Get file version info (if available) for previous file (if it exists) */
1306 }
1327 /* Old file not found, so by definition new file is in fact newer */
1330 errno));
1338 }
1342 old_file));
1346 }
1350 }
1351 }
1355 /* Get file version info (if available) for new file */
1359 }
1380 /* New file not found, this shouldn't occur if the caller did its job */
1389 }
1393 new_file));
1397 }
1401 }
1402 }
1407 /* Compare versions and choose the larger version number */
1414 }
1419 }
1422 /* Compare modification time/dates and choose the newest time/date */
1427 }
1432 }
1433 }
1435 error_exit:
1439 done:
1442 }
1444 /****************************************************************************
1445 Determine the correct cVersion associated with an architecture and driver
1446 ****************************************************************************/
1451 {
1453 NTSTATUS nt_status;
1458 NTSTATUS status;
1460 fstring printdollar;
1465 /* If architecture is Windows 95/98/ME, the version is always 0. */
1470 }
1472 /* If architecture is Windows x64, the version is always 3. */
1477 }
1485 }
1495 }
1497 /* Open the driver file (Portable Executable format) and determine the
1498 * deriver the cversion. */
1501 architecture,
1502 driverpath_in);
1506 }
1512 }
1518 }
1544 uint32 major;
1545 uint32 minor;
1556 }
1558 /*
1559 * This is a Microsoft'ism. See references in MSDN to VER_FILEVERSION
1560 * for more details. Version in this case is not just the version of the
1561 * file, but the version in the sense of kernal mode (2) vs. user mode
1562 * (3) drivers. Other bits of the version fields are the version info.
1563 * JRR 010716
1564 */
1575 cversion));
1577 }
1582 }
1589 error_exit:
1591 done:
1595 }
1599 }
1602 }
1604 }
1606 /****************************************************************************
1607 ****************************************************************************/
1609 #define strip_driver_path(_mem_ctx, _element) do { \
1612 W_ERROR_HAVE_NO_MEMORY((_element)); \
1613 } \
1614 } while (0);
1625 {
1628 WERROR err;
1633 }
1635 /* clean up the driver name.
1636 * we can get .\driver.dll
1637 * or worse c:\windows\system\driver.dll !
1638 */
1639 /* using an intermediate string to not have overlaping memcpy()'s */
1646 }
1651 }
1652 }
1657 }
1659 /* jfm:7/16/2000 the client always sends the cversion=0.
1660 * The server should check which version the driver is by reading
1661 * the PE header of driver->driverpath.
1662 *
1663 * For Windows 95/98 the version is 0 (so the value sent is correct)
1664 * For Windows NT (the architecture doesn't matter)
1665 * NT 3.1: cversion=0
1666 * NT 3.5/3.51: cversion=1
1667 * NT 4: cversion=2
1668 * NT2K: cversion=3
1669 */
1675 }
1678 }
1680 /****************************************************************************
1681 ****************************************************************************/
1685 {
1707 }
1708 }
1710 /****************************************************************************
1711 This function sucks and should be replaced. JRA.
1712 ****************************************************************************/
1716 {
1729 }
1731 /****************************************************************************
1732 This function sucks and should be replaced. JRA.
1733 ****************************************************************************/
1738 {
1754 }
1755 }
1757 /****************************************************************************
1758 ****************************************************************************/
1766 {
1771 NTSTATUS status;
1772 WERROR ret;
1783 }
1791 }
1793 /* Setup a synthetic smb_filename struct */
1798 }
1807 OPENX_FILE_EXISTS_TRUNCATE |
1808 OPENX_FILE_CREATE_IF_NOT_EXIST,
1818 }
1819 }
1822 out:
1826 }
1831 {
1838 NTSTATUS nt_status;
1843 fstring printdollar;
1859 }
1864 }
1872 }
1882 }
1886 short_architecture,
1891 }
1896 }
1902 /* For each driver file, archi\filexxx.yyy, if there is a duplicate file
1903 * listed for this driver which has already been moved, skip it (note:
1904 * drivers may list the same file name several times. Then check if the
1905 * file already exists in archi\version\, if so, check that the version
1906 * info (or time stamps if version info is unavailable) is newer (or the
1907 * date is later). If it is, move it to archi\version\filexxx.yyy.
1908 * Otherwise, delete the file.
1909 *
1910 * If a file is not moved to archi\version\ because of an error, all the
1911 * rest of the 'unmoved' driver files are removed from archi\. If one or
1912 * more of the driver's files was already moved to archi\version\, it
1913 * potentially leaves the driver in a partially updated state. Version
1914 * trauma will most likely occur if an client attempts to use any printer
1915 * bound to the driver. Perhaps a rewrite to make sure the moves can be
1916 * done is appropriate... later JRR
1917 */
1924 conn,
1926 short_architecture,
1928 ver);
1932 }
1934 }
1935 }
1941 conn,
1943 short_architecture,
1945 ver);
1949 }
1951 }
1952 }
1953 }
1960 conn,
1962 short_architecture,
1964 ver);
1968 }
1970 }
1971 }
1972 }
1980 conn,
1982 short_architecture,
1984 ver);
1988 }
1990 }
1991 }
1992 }
2004 }
2005 }
2008 conn,
2010 short_architecture,
2012 ver);
2016 }
2018 }
2019 }
2020 NextDriver: ;
2021 }
2022 }
2024 err_exit:
2030 }
2034 }
2037 }
2039 }
2041 /****************************************************************************
2042 ****************************************************************************/
2045 {
2053 TDB_DATA dbuf;
2058 }
2060 /* The names are relative. We store them in the form: \print$\arch\version\driver.xxx
2061 * \\server is added in the rpc server layer.
2062 * It does make sense to NOT store the server's name in the printer TDB.
2063 */
2069 }
2071 #define gen_full_driver_unc_path(ctx, directory, file) \
2072 do { \
2073 if (file && strlen(file)) { \
2075 } else { \
2077 } \
2078 if (!file) { \
2079 return (uint32_t)-1; \
2080 } \
2081 } while (0);
2083 /* .inf files do not always list a file for each of the four standard files.
2084 * Don't prepend a path to a null filename, or client claims:
2085 * "The server on which the printer resides does not have a suitable
2086 * <printer driver name> printer driver installed. Click OK if you
2087 * wish to install the driver on your local machine."
2088 */
2099 }
2100 }
2106 }
2113 again:
2130 }
2131 }
2139 }
2142 }
2149 done:
2155 }
2157 /****************************************************************************
2158 ****************************************************************************/
2161 {
2172 }
2174 /****************************************************************************
2175 ****************************************************************************/
2180 {
2184 }
2189 }
2197 }
2200 }
2202 /****************************************************************************
2203 ****************************************************************************/
2209 {
2210 TDB_DATA dbuf;
2215 fstring name, driverpath, environment, datafile, configfile, helpfile, monitorname, defaultdatatype;
2220 }
2222 /* Windows 4.0 (i.e. win9x) should always use a version of 0 */
2227 DEBUG(8,("get_a_printer_driver_3: [%s%s/%d/%s]\n", DRIVERS_PREFIX, architecture, version, drivername));
2232 }
2238 }
2242 name,
2243 environment,
2244 driverpath,
2245 datafile,
2246 configfile,
2247 helpfile,
2248 monitorname,
2249 defaultdatatype);
2264 fstring file;
2270 }
2277 i++;
2278 }
2288 }
2291 }
2293 /****************************************************************************
2294 ****************************************************************************/
2296 {
2347 }
2352 }
2354 /****************************************************************************
2355 Pack all values in all printer keys
2356 ***************************************************************************/
2359 {
2370 /* loop over all keys */
2376 /* pack the keyname followed by a empty value */
2381 REG_NONE,
2383 NULL);
2385 /* now loop over all values */
2388 /* pathname should be stored as <key>\<value> */
2395 }
2398 val,
2399 path,
2406 }
2408 }
2410 /* terminator */
2415 }
2418 /****************************************************************************
2419 Delete a printer - this just deletes the printer info file, any open
2420 handles are not affected.
2421 ****************************************************************************/
2424 {
2425 TDB_DATA kbuf;
2442 }
2445 }
2448 }
2450 /****************************************************************************
2451 ****************************************************************************/
2453 {
2457 WERROR ret;
2460 /*
2461 * in addprinter: no servername and the printer is the name
2462 * in setprinter: servername is \\server
2463 * and printer is \\server\\printer
2464 *
2465 * Samba manages only local printers.
2466 * we currently don't support things like i
2467 * path=\\other_server\printer
2468 *
2469 * We only store the printername, not \\server\printername
2470 */
2476 }
2478 /*
2479 * JFM: one day I'll forget.
2480 * below that's info->portname because that's the SAMBA sharename
2481 * and I made NT 'thinks' it's the portname
2482 * the info->sharename is the thing you can name when you add a printer
2483 * that's the short-name when you create shared printer for 95/98
2484 * So I've made a limitation in SAMBA: you can only have 1 printer model
2485 * behind a SAMBA share.
2486 */
2491 again:
2522 }
2531 }
2534 }
2543 done:
2553 }
2555 /****************************************************************************
2556 Create and allocate a default devicemode.
2557 ****************************************************************************/
2562 {
2569 }
2574 }
2577 }
2583 }
2590 DEVMODE_TTOPTION |
2591 DEVMODE_PRINTQUALITY |
2592 DEVMODE_DEFAULTSOURCE |
2593 DEVMODE_COPIES |
2594 DEVMODE_SCALE |
2595 DEVMODE_PAPERSIZE |
2596 DEVMODE_ORIENTATION;
2631 }
2635 {
2641 DOM_SID adm_sid;
2644 /* Create an ACE where Everyone is allowed to print */
2650 /* Add the domain admins group if we are a DC */
2653 DOM_SID domadmins_sid;
2656 DOMAIN_GROUP_RID_ADMINS);
2664 }
2674 }
2676 /* add BUILTIN\Administrators as FULL CONTROL */
2683 SEC_ACE_TYPE_ACCESS_ALLOWED,
2686 /* Make the security descriptor owned by the BUILTIN\Administrators */
2688 /* The ACL revision number in rpc_secdesc.h differs from the one
2689 created by NT when setting ACE entries in printer
2690 descriptors. NT4 complains about the property being edited by a
2691 NT5 machine. */
2695 SEC_DESC_REVISION,
2696 SEC_DESC_SELF_RELATIVE,
2699 NULL,
2700 psa,
2702 }
2707 }
2715 }
2717 /****************************************************************************
2718 Malloc and return an NT devicemode.
2719 ****************************************************************************/
2722 {
2730 }
2744 DEVMODE_TTOPTION |
2745 DEVMODE_PRINTQUALITY |
2746 DEVMODE_DEFAULTSOURCE |
2747 DEVMODE_COPIES |
2748 DEVMODE_SCALE |
2749 DEVMODE_PAPERSIZE |
2750 DEVMODE_ORIENTATION;
2769 /* non utilisés par un driver d'imprimante */
2783 }
2785 /****************************************************************************
2786 Clean up and deallocate a (maybe partially) allocated NT_DEVICEMODE.
2787 ****************************************************************************/
2790 {
2800 }
2802 /****************************************************************************
2803 Clean up and deallocate a (maybe partially) allocated NT_PRINTER_INFO_LEVEL_2.
2804 ****************************************************************************/
2807 {
2816 }
2819 /****************************************************************************
2820 ****************************************************************************/
2822 {
2825 NT_DEVICEMODE devmode;
2873 /* the len in tdb_unpack is an int value and
2874 * devmode.driverextra is only a short
2875 */
2879 /* check to catch an invalid TDB entry so we don't segfault */
2882 }
2883 }
2889 }
2896 }
2898 /****************************************************************************
2899 Allocate and initialize a new slot.
2900 ***************************************************************************/
2903 {
2910 /* allocate another slot in the NT_PRINTER_KEY array */
2915 }
2921 /* initialze new key */
2933 }
2935 /****************************************************************************
2936 search for a registry key name in the existing printer data
2937 ***************************************************************************/
2940 {
2946 /* cleanup memory */
2951 /* if not the end of the array, move remaining elements down one slot */
2958 }
2959 }
2963 }
2965 /****************************************************************************
2966 search for a registry key name in the existing printer data
2967 ***************************************************************************/
2970 {
2979 /* loop over all existing keys */
2987 }
2988 }
2991 }
2993 /****************************************************************************
2994 ***************************************************************************/
2997 {
3003 fstring subkeyname;
3013 /* special case of asking for the top level printer data registry key names */
3018 /* found a match, so allocate space and copy the name */
3024 }
3027 num_subkeys++;
3028 }
3031 }
3033 /* asking for the subkeys of some key */
3034 /* subkey paths are stored in the key name using '\' as the delimiter */
3039 /* if we found the exact key, then break */
3044 /* get subkey path */
3048 p++;
3053 /* don't add a key more than once */
3058 }
3063 /* found a match, so allocate space and copy the name */
3069 }
3072 num_subkeys++;
3073 }
3075 }
3077 /* return error if the key was not found */
3082 }
3084 done:
3085 /* tag off the end */
3093 }
3095 #ifdef HAVE_ADS
3098 {
3101 }
3104 uint32 dword)
3105 {
3109 }
3113 {
3118 }
3122 {
3130 }
3132 /****************************************************************************
3133 * Map the NT_PRINTER_INFO_LEVEL_2 data into DsSpooler keys for publishing.
3134 *
3135 * @param info2 NT_PRINTER_INFO_LEVEL_2 describing printer - gets modified
3136 * @return bool indicating success or failure
3137 ***************************************************************************/
3140 {
3142 fstring longname;
3155 /* we make the assumption that the netbios name is the same
3156 as the DNS name sinc ethe former will be what we used to
3157 join the domain */
3164 }
3170 }
3186 PRINTER_ATTRIBUTE_KEEPPRINTEDJOBS));
3200 }
3204 }
3206 /*****************************************************************
3207 ****************************************************************/
3211 {
3215 /* find the DsSpooler key */
3222 /* We used to store this as a REG_BINARY but that causes
3223 Vista to whine */
3227 }
3231 {
3232 ADS_STATUS ads_rc;
3237 ADS_MODLIST mods;
3243 /* build the ads mods */
3247 }
3251 /* figure out where to publish */
3254 /* We use ldap_get_dn here as we need the answer
3255 * in utf8 to call ldap_explode_dn(). JRA. */
3261 }
3268 }
3269 /* Now convert to CH_UNIX. */
3275 }
3282 }
3291 }
3297 }
3310 }
3316 /* publish it */
3321 ;
3324 }
3329 /* retreive the guid and store it locally */
3336 }
3340 }
3344 {
3345 ADS_STATUS ads_rc;
3351 /* remove the printer from the directory */
3360 }
3363 }
3367 }
3369 }
3371 /****************************************************************************
3372 * Publish a printer in the directory
3373 *
3374 * @param snum describing printer service
3375 * @return WERROR indicating status of publishing
3376 ***************************************************************************/
3379 {
3380 ADS_STATUS ads_rc;
3383 WERROR win_rc;
3392 /* set the DsSpooler info and attributes */
3396 }
3406 }
3412 }
3419 }
3425 /* ads_connect() will find the DC for us */
3431 }
3441 }
3443 done:
3447 }
3450 {
3451 ADS_STATUS ads_rc;
3461 }
3467 /* ads_connect() will find the DC for us */
3474 }
3486 }
3491 }
3495 {
3499 WERROR win_rc;
3502 DATA_BLOB blob;
3511 {
3514 }
3516 /* fetching printer guids really ought to be a separate function. */
3521 /* We used to store the guid as REG_BINARY, then swapped
3522 to REG_SZ for Vista compatibility so check for both */
3536 }
3543 }
3544 }
3548 }
3549 #else
3551 {
3553 }
3556 {
3558 }
3562 {
3564 }
3567 /****************************************************************************
3568 ***************************************************************************/
3571 {
3583 /* remove all keys */
3595 }
3597 /* remove a specific key (and all subkeys) */
3607 /* mark the slot as empty */
3610 }
3611 }
3613 /* find the first empty slot */
3618 removed_keys++;
3620 }
3621 }
3624 /* nothing was removed */
3627 /* move everything down */
3633 empty_slot++;
3634 removed_keys++;
3635 }
3636 }
3638 /* update count */
3642 /* sanity check to see if anything is left */
3649 }
3652 }
3654 /****************************************************************************
3655 ***************************************************************************/
3658 {
3662 /* we must have names on non-zero length */
3667 /* find the printer key first */
3673 /* make sure the value exists so we can return the correct error code */
3684 }
3686 /****************************************************************************
3687 ***************************************************************************/
3691 {
3695 /* we must have names on non-zero length */
3700 /* find the printer key first */
3716 }
3718 /****************************************************************************
3719 ***************************************************************************/
3721 struct regval_blob* get_printer_data( NT_PRINTER_INFO_LEVEL_2 *p2, const char *key, const char *value )
3722 {
3732 }
3734 /****************************************************************************
3735 Unpack a list of registry values frem the TDB
3736 ***************************************************************************/
3739 {
3741 uint32 type;
3742 fstring string;
3751 /* add the "PrinterDriverData" key first for performance reasons */
3755 /* loop and unpack the rest of the registry values */
3759 /* check to see if there are any more registry values */
3766 /* unpack the next regval */
3769 string,
3774 /* lookup for subkey names which have a type of REG_NONE */
3775 /* there's no data with this entry */
3781 }
3783 /*
3784 * break of the keyname from the value name.
3785 * Valuenames can have embedded '\'s so be careful.
3786 * only support one level of keys. See the
3787 * "Konica Fiery S300 50C-K v1.1. enu" 2k driver.
3788 * -- jerry
3789 */
3793 /* Put in "PrinterDriverData" is no key specified */
3798 }
3803 }
3805 /* see if we need a new key */
3812 keyname));
3814 }
3818 /* Vista doesn't like unknown REG_BINARY values in DsSpooler.
3819 Thanks to Martin Zielinski for the hint. */
3824 {
3827 /* convert the GUID to a UNICODE string */
3832 valuename,
3836 /* add the value */
3840 size );
3841 }
3845 }
3848 }
3850 /****************************************************************************
3851 ***************************************************************************/
3857 {
3860 }
3862 }
3865 {
3868 }
3870 }
3873 {
3887 }
3889 }
3892 {
3909 }
3916 }
3930 nt_name++;
3935 {
3939 l--;
3940 }
3941 }
3944 os2_name++;
3946 {
3950 l--;
3951 }
3952 }
3960 }
3961 }
3964 }
3966 /****************************************************************************
3967 Get a default printer info 2 struct.
3968 ****************************************************************************/
3974 {
3983 /* by setting the driver name to an empty string, a local NT admin
3984 can now run the **local** APW to install a local printer driver
3985 for a Samba shared printer in 2.2. Without this, drivers **must** be
3986 installed on the Samba server for NT clients --jerry */
3990 #endif
3999 #ifdef HAVE_CUPS
4001 /* Pull the location and comment strings from cups if we don't
4002 already have one */
4012 }
4013 }
4014 }
4015 #endif
4025 /*
4026 * I changed this as I think it is better to have a generic
4027 * DEVMODE than to crash Win2k explorer.exe --jerry
4028 * See the HP Deskjet 990c Win2k drivers for an example.
4029 *
4030 * However the default devmode appears to cause problems
4031 * with the HP CLJ 8500 PCL driver. Hence the addition of
4032 * the "default devmode" parameter --jerry 22/01/2002
4033 */
4038 }
4041 }
4045 }
4050 }
4056 fail:
4061 }
4063 /****************************************************************************
4064 ****************************************************************************/
4070 {
4074 fstring printername;
4084 }
4113 }
4115 /* Samba has to have shared raw drivers. */
4119 /* Restore the stripped strings. */
4126 }
4130 #ifdef HAVE_CUPS
4132 /* Pull the location and comment strings from cups if we don't
4133 already have one */
4143 }
4144 }
4145 }
4146 #endif
4150 /*
4151 * Some client drivers freak out if there is a NULL devmode
4152 * (probably the driver is not checking before accessing
4153 * the devmode pointer) --jerry
4154 *
4155 * See comments in get_a_printer_2_default()
4156 */
4160 printername));
4162 }
4167 }
4173 }
4176 /* This will get the current RPC talloc context, but we should be
4177 passing this as a parameter... fixme... JRA ! */
4182 }
4184 /* Fix for OS/2 drivers. */
4188 }
4196 }
4198 /****************************************************************************
4199 Debugging function, dump at level 6 the struct in the logs.
4200 ****************************************************************************/
4202 {
4203 uint32 result;
4210 {
4213 else
4214 {
4241 }
4243 }
4248 }
4251 }
4253 /****************************************************************************
4254 Update the changeid time.
4255 This is SO NASTY as some drivers need this to change, others need it
4256 static. This value will change every second, and I must hope that this
4257 is enough..... DON'T CHANGE THIS CODE WITHOUT A TEST MATRIX THE SIZE OF
4258 UTAH ! JRA.
4259 ****************************************************************************/
4262 {
4268 /* Return changeid as msec since spooler restart */
4270 #else
4271 /*
4272 * This setting seems to work well but is too untested
4273 * to replace the above calculation. Left in for experiementation
4274 * of the reader --jerry (Tue Mar 12 09:15:05 CST 2002)
4275 */
4277 #endif
4278 }
4281 /*
4282 * The function below are the high level ones.
4283 * only those ones must be called from the spoolss code.
4284 * JFM.
4285 */
4287 /****************************************************************************
4288 Modify a printer. This is called from SETPRINTERDATA/DELETEPRINTERDATA.
4289 ****************************************************************************/
4292 {
4293 WERROR result;
4299 {
4300 /*
4301 * Update the changestamp. Emperical tests show that the
4302 * ChangeID is always updated,but c_setprinter is
4303 * global spooler variable (not per printer).
4304 */
4306 /* ChangeID **must** be increasing over the lifetime
4307 of client's spoolss service in order for the
4308 client's cache to show updates */
4312 /*
4313 * Because one day someone will ask:
4314 * NT->NT An admin connection to a remote
4315 * printer show changes imeediately in
4316 * the properities dialog
4317 *
4318 * A non-admin connection will only show the
4319 * changes after viewing the properites page
4320 * 2 times. Seems to be related to a
4321 * race condition in the client between the spooler
4322 * updating the local cache and the Explorer.exe GUI
4323 * actually displaying the properties.
4324 *
4325 * This is fixed in Win2k. admin/non-admin
4326 * connections both display changes immediately.
4327 *
4328 * 14/12/01 --jerry
4329 */
4333 }
4337 }
4340 }
4342 /****************************************************************************
4343 Initialize printer devmode & data with previously saved driver init values.
4344 ****************************************************************************/
4347 {
4350 TDB_DATA dbuf;
4351 NT_PRINTER_INFO_LEVEL_2 info;
4356 /*
4357 * Delete any printer data 'values' already set. When called for driver
4358 * replace, there will generally be some, but during an add printer, there
4359 * should not be any (if there are delete them).
4360 */
4368 }
4372 /*
4373 * When changing to a driver that has no init info in the tdb, remove
4374 * the previous drivers init info and leave the new on blank.
4375 */
4379 }
4382 /*
4383 * Get the saved DEVMODE..
4384 */
4388 /*
4389 * The saved DEVMODE contains the devicename from the printer used during
4390 * the initialization save. Change it to reflect the new printer.
4391 */
4396 }
4398 /*
4399 * NT/2k does not change out the entire DeviceMode of a printer
4400 * when changing the driver. Only the driverextra, private, &
4401 * driverversion fields. --jerry (Thu Mar 14 08:58:43 CST 2002)
4402 *
4403 * Later examination revealed that Windows NT/2k does reset the
4404 * the printer's device mode, bit **only** when you change a
4405 * property of the device mode such as the page orientation.
4406 * --jerry
4407 */
4410 /* Bind the saved DEVMODE to the new the printer */
4418 /* Add the printer data 'values' to the new printer */
4423 }
4430 }
4432 /****************************************************************************
4433 Initialize printer devmode & data with previously saved driver init values.
4434 When a printer is created using AddPrinter, the drivername bound to the
4435 printer is used to lookup previously saved driver initialization info, which
4436 is bound to the new printer.
4437 ****************************************************************************/
4440 {
4450 level));
4452 }
4455 }
4457 /****************************************************************************
4458 Delete driver init data stored for a specified driver
4459 ****************************************************************************/
4462 {
4469 }
4473 }
4476 drivername));
4481 }
4483 /****************************************************************************
4484 Pack up the DEVMODE and values for a printer into a 'driver init' entry
4485 in the tdb. Note: this is different from the driver entry and the printer
4486 entry. There should be a single driver init entry for each driver regardless
4487 of whether it was installed from NT or 2K. Technically, they should be
4488 different, but they work out to the same struct.
4489 ****************************************************************************/
4492 {
4497 TDB_DATA dbuf;
4502 again:
4510 }
4519 }
4522 }
4528 }
4535 done:
4545 }
4547 /****************************************************************************
4548 Update (i.e. save) the driver init info (DEVMODE and values) for a printer
4549 ****************************************************************************/
4552 {
4553 uint32 result;
4564 }
4567 }
4569 /****************************************************************************
4570 Convert the printer data value, a REG_BINARY array, into an initialization
4571 DEVMODE. Note: the array must be parsed as if it was a DEVMODE in an rpc...
4572 got to keep the endians happy :).
4573 ****************************************************************************/
4577 {
4580 DATA_BLOB blob;
4591 }
4594 }
4596 /****************************************************************************
4597 Set the DRIVER_INIT info in the tdb. Requires Win32 client code that:
4599 1. Use the driver's config DLL to this UNC printername and:
4600 a. Call DrvPrintEvent with PRINTER_EVENT_INITIALIZE
4601 b. Call DrvConvertDevMode with CDM_DRIVER_DEFAULT to get default DEVMODE
4602 2. Call SetPrinterData with the 'magic' key and the DEVMODE as data.
4604 The last step triggers saving the "driver initialization" information for
4605 this printer into the tdb. Later, new printers that use this driver will
4606 have this initialization information bound to them. This simulates the
4607 driver initialization, as if it had run on the Samba server (as it would
4608 have done on NT).
4610 The Win32 client side code requirement sucks! But until we can run arbitrary
4611 Win32 printer driver code on any Unix that Samba runs on, we are stuck with it.
4613 It would have been easier to use SetPrinter because all the UNMARSHALLING of
4614 the DEVMODE is done there, but 2K/XP clients do not set the DEVMODE... think
4615 about it and you will realize why. JRR 010720
4616 ****************************************************************************/
4618 static WERROR save_driver_init_2(NT_PRINTER_INFO_LEVEL *printer, uint8 *data, uint32 data_len )
4619 {
4625 /*
4626 * When the DEVMODE is already set on the printer, don't try to unpack it.
4627 */
4631 /*
4632 * Set devmode on printer info, so entire printer initialization can be
4633 * saved to tdb.
4634 */
4642 }
4646 /*
4647 * The DEVMODE is held in the 'data' component of the param in raw binary.
4648 * Convert it to to a devmode structure
4649 */
4654 }
4657 }
4659 /*
4660 * Pack up and add (or update) the DEVMODE and any current printer data to
4661 * a 'driver init' element in the tdb
4662 *
4663 */
4669 }
4671 /*
4672 * If driver initialization info was successfully saved, set the current
4673 * printer to match it. This allows initialization of the current printer
4674 * as well as the driver.
4675 */
4680 }
4682 done:
4689 }
4691 /****************************************************************************
4692 Update the driver init info (DEVMODE and specifics) for a printer
4693 ****************************************************************************/
4695 WERROR save_driver_init(NT_PRINTER_INFO_LEVEL *printer, uint32 level, uint8 *data, uint32 data_len)
4696 {
4706 }
4709 }
4711 /****************************************************************************
4712 Get a NT_PRINTER_INFO_LEVEL struct. It returns malloced memory.
4714 Previously the code had a memory allocation problem because it always
4715 used the TALLOC_CTX from the Printer_entry*. This context lasts
4716 as a long as the original handle is open. So if the client made a lot
4717 of getprinter[data]() calls, the memory usage would climb. Now we use
4718 a short lived TALLOC_CTX for printer_info_2 objects returned. We
4719 still use the Printer_entry->ctx for maintaining the cache copy though
4720 since that object must live as long as the handle by definition.
4721 --jerry
4723 ****************************************************************************/
4725 static WERROR get_a_printer_internal( Printer_entry *print_hnd, NT_PRINTER_INFO_LEVEL **pp_printer, uint32 level,
4727 {
4728 WERROR result;
4729 fstring servername;
4736 }
4744 }
4752 }
4757 /* we have a new printer now. Save it with this handle */
4764 }
4773 }
4776 }
4780 uint32 level,
4782 {
4785 }
4789 uint32 level,
4791 {
4794 }
4796 /****************************************************************************
4797 Deletes a NT_PRINTER_INFO_LEVEL struct.
4798 ****************************************************************************/
4801 {
4816 }
4821 }
4823 /****************************************************************************
4824 ****************************************************************************/
4828 {
4846 }
4860 }
4880 }
4883 }
4894 }
4897 if (r->info.info8->core_driver_dependencies && r->info.info8->core_driver_dependencies->string) {
4899 }
4905 }
4910 }
4917 {
4926 }
4931 }
4935 }
4937 /****************************************************************************
4938 ****************************************************************************/
4944 {
4945 WERROR result;
4951 /* Sometime we just want any version of the driver */
4954 /* look for Win2k first and then for NT4 */
4957 drivername,
4962 drivername,
4964 }
4968 drivername,
4969 architecture,
4970 version);
4971 }
4975 }
4980 }
4996 }
4998 /****************************************************************************
4999 ****************************************************************************/
5002 {
5005 }
5008 /****************************************************************************
5009 Determine whether or not a particular driver is currently assigned
5010 to a printer
5011 ****************************************************************************/
5014 {
5022 }
5026 /* loop through the printers.tdb and check for the drivername */
5039 }
5045 WERROR werr;
5049 /* we can still remove the driver if there is one of
5050 "Windows NT x86" version 2 or 3 left */
5053 werr = get_a_printer_driver(talloc_tos(), &d, r->driver_name, "Windows NT x86", DRIVER_ANY_VERSION);
5054 }
5068 }
5069 }
5071 /* now check the error code */
5074 /* it's ok to remove the driver, we have other architctures left */
5077 }
5078 }
5080 /* report that the driver is not in use by default */
5083 }
5086 /**********************************************************************
5087 Check to see if a ogiven file is in use by *info
5088 *********************************************************************/
5091 {
5097 /* mz: skip files that are in the list but already deleted */
5100 }
5114 /* see of there are any dependent files to examine */
5122 i++;
5123 }
5127 }
5129 /**********************************************************************
5130 Utility function to remove the dependent file pointed to by the
5131 input parameter from the list
5132 *********************************************************************/
5135 {
5137 /* bump everything down a slot */
5141 idx++;
5142 }
5147 }
5149 /**********************************************************************
5150 Check if any of the files used by src are also used by drv
5151 *********************************************************************/
5156 {
5163 /* check each file. Remove it from the src structure if it overlaps */
5170 }
5177 }
5184 }
5191 }
5193 /* are there any dependentfiles to examine? */
5204 i++;
5205 }
5208 }
5210 /****************************************************************************
5211 Determine whether or not a particular driver files are currently being
5212 used by any other driver.
5214 Return value is True if any files were in use by other drivers
5215 and False otherwise.
5217 Upon return, *info has been modified to only contain the driver files
5218 which are not in use
5220 Fix from mz:
5222 This needs to check all drivers to ensure that all files in use
5223 have been removed from *info, not just the ones in the first
5224 match.
5225 ****************************************************************************/
5229 {
5232 uint32 version;
5242 /* loop over all driver versions */
5246 /* get the list of drivers */
5254 /* check each driver for overlap in files */
5261 if (!W_ERROR_IS_OK(get_a_printer_driver(talloc_tos(), &driver, list[i], info->architecture, version))) {
5264 }
5266 /* check if d2 uses any files from d1 */
5267 /* only if this is a different driver than the one being deleted */
5271 /* mz: Do not instantly return -
5272 * we need to ensure this file isn't
5273 * also in use by other drivers. */
5275 }
5276 }
5279 }
5286 }
5290 {
5292 NTSTATUS status;
5298 }
5304 }
5306 /****************************************************************************
5307 Actually delete the driver files. Make sure that
5308 printer_driver_files_in_use() return False before calling
5309 this.
5310 ****************************************************************************/
5314 {
5319 NTSTATUS nt_status;
5321 fstring printdollar;
5327 }
5337 }
5346 }
5351 }
5353 /* now delete the files; must strip the '\print$' string from
5354 fron of path */
5361 }
5362 }
5369 }
5370 }
5377 }
5378 }
5385 }
5386 }
5388 /* check if we are done removing files */
5394 /* bypass the "\print$" portion of the path */
5400 }
5402 i++;
5403 }
5404 }
5407 fail:
5409 done:
5413 }
5415 }
5417 /****************************************************************************
5418 Remove a printer driver from the TDB. This assumes that the the driver was
5419 previously looked up.
5420 ***************************************************************************/
5425 {
5428 TDB_DATA dbuf;
5430 /* delete the tdb data first */
5435 }
5439 }
5444 /* check if the driver actually exists for this environment */
5451 }
5455 /* ok... the driver exists so the delete should return success */
5461 }
5463 /*
5464 * now delete any associated files if delete_files == True
5465 * even if this part failes, we return succes because the
5466 * driver doesn not exist any more
5467 */
5476 }
5478 /****************************************************************************
5479 Store a security desc for a printer.
5480 ****************************************************************************/
5483 {
5487 TDB_DATA kbuf;
5488 TDB_DATA dbuf;
5489 DATA_BLOB blob;
5490 WERROR status;
5491 NTSTATUS nt_status;
5497 /* The old owner and group sids of the security descriptor are not
5498 present when new ACEs are added or removed by changing printer
5499 permissions through NT. If they are NULL in the new security
5500 descriptor then copy them over from the old one. */
5511 }
5513 /* Pick out correct owner and group sids */
5531 /* Make a deep copy of the security descriptor */
5535 sacl,
5536 dacl,
5542 }
5545 }
5549 }
5551 /* Store the security descriptor in a tdb */
5558 }
5570 }
5572 /* Free malloc'ed memory */
5575 out:
5580 }
5582 /****************************************************************************
5583 Construct a default security descriptor buffer for a printer.
5584 ****************************************************************************/
5587 {
5594 DOM_SID adm_sid;
5597 /* Create an ACE where Everyone is allowed to print */
5603 /* Add the domain admins group if we are a DC */
5606 DOM_SID domadmins_sid;
5609 DOMAIN_GROUP_RID_ADMINS);
5617 }
5627 }
5629 /* add BUILTIN\Administrators as FULL CONTROL */
5636 SEC_ACE_TYPE_ACCESS_ALLOWED,
5639 /* Make the security descriptor owned by the BUILTIN\Administrators */
5641 /* The ACL revision number in rpc_secdesc.h differs from the one
5642 created by NT when setting ACE entries in printer
5643 descriptors. NT4 complains about the property being edited by a
5644 NT5 machine. */
5651 }
5656 }
5664 }
5666 /****************************************************************************
5667 Get a security desc for a printer.
5668 ****************************************************************************/
5671 {
5672 TDB_DATA kbuf;
5673 TDB_DATA dbuf;
5674 DATA_BLOB blob;
5676 NTSTATUS status;
5680 }
5682 /* Fetch security descriptor from tdb */
5690 secdesc_ctr);
5695 }
5696 }
5701 }
5710 }
5712 /* If security descriptor is owned by S-1-1-0 and winbindd is up,
5713 this security descriptor has been created when winbindd was
5714 down. Take ownership of security descriptor. */
5717 DOM_SID owner_sid;
5719 /* Change sd owner to workgroup administrator */
5726 /* Create new sd */
5739 }
5744 }
5746 /* Swap with other one */
5750 /* Set it */
5753 }
5754 }
5768 }
5769 }
5772 }
5774 /* error code:
5775 0: everything OK
5776 1: level not implemented
5777 2: file doesn't exist
5778 3: can't allocate memory
5779 4: can't free memory
5780 5: non existant struct
5781 */
5783 /*
5784 A printer and a printer driver are 2 different things.
5785 NT manages them separatelly, Samba does the same.
5786 Why ? Simply because it's easier and it makes sense !
5788 Now explanation: You have 3 printers behind your samba server,
5789 2 of them are the same make and model (laser A and B). But laser B
5790 has an 3000 sheet feeder and laser A doesn't such an option.
5791 Your third printer is an old dot-matrix model for the accounting :-).
5793 If the /usr/local/samba/lib directory (default dir), you will have
5794 5 files to describe all of this.
5796 3 files for the printers (1 by printer):
5797 NTprinter_laser A
5798 NTprinter_laser B
5799 NTprinter_accounting
5800 2 files for the drivers (1 for the laser and 1 for the dot matrix)
5801 NTdriver_printer model X
5802 NTdriver_printer model Y
5804 jfm: I should use this comment for the text file to explain
5805 same thing for the forms BTW.
5806 Je devrais mettre mes commentaires en francais, ca serait mieux :-)
5808 */
5810 /* Convert generic access rights to printer object specific access rights.
5811 It turns out that NT4 security descriptors use generic access rights and
5812 NT5 the object specific ones. */
5815 {
5821 }
5822 }
5825 {
5831 }
5832 }
5835 /****************************************************************************
5836 Check a user has permissions to perform the given operation. We use the
5837 permission constants defined in include/rpc_spoolss.h to check the various
5838 actions we perform when checking printer access.
5840 PRINTER_ACCESS_ADMINISTER:
5841 print_queue_pause, print_queue_resume, update_printer_sec,
5842 update_printer, spoolss_addprinterex_level_2,
5843 _spoolss_setprinterdata
5845 PRINTER_ACCESS_USE:
5846 print_job_start
5848 JOB_ACCESS_ADMINISTER:
5849 print_job_delete, print_job_pause, print_job_resume,
5850 print_queue_purge
5852 Try access control in the following order (for performance reasons):
5853 1) root and SE_PRINT_OPERATOR can do anything (easy check)
5854 2) check security descriptor (bit comparisons in memory)
5855 3) "printer admins" (may result in numerous calls to winbind)
5857 ****************************************************************************/
5860 {
5862 uint32 access_granted;
5863 NTSTATUS status;
5868 /* If user is NULL then use the current_user structure */
5870 /* Always allow root or SE_PRINT_OPERATROR to do anything */
5875 }
5877 /* Get printer name */
5884 }
5886 /* Get printer security descriptor */
5891 }
5897 }
5902 /* Create a child security descriptor to check permissions
5903 against. This is because print jobs are child objects
5904 objects of a printer. */
5912 }
5917 }
5919 /* Check access */
5925 /* see if we need to try the printer admin list */
5933 }
5939 }
5942 }
5944 /****************************************************************************
5945 Check the time parameters allow a print operation.
5946 *****************************************************************************/
5949 {
5954 uint32 mins;
5974 }
5976 /****************************************************************************
5977 Fill in the servername sent in the _spoolss_open_printer_ex() call
5978 ****************************************************************************/
5981 {
5983 }