smb.h

   1 /* smb.h
   2  * Defines for smb packet dissection
   3  * Copyright 1999, Richard Sharpe <rsharpe@ns.aus.com>
   4  *
   5  * $Id: smb.h,v 1.54 2003/12/18 00:18:55 guy Exp $
   6  *
   7  * Ethereal - Network traffic analyzer
   8  * By Gerald Combs <gerald@ethereal.com>
   9  * Copyright 1998, 1999 Gerald Combs
  10  *
  11  * This program is free software; you can redistribute it and/or
  12  * modify it under the terms of the GNU General Public License
  13  * as published by the Free Software Foundation; either version 2
  14  * of the License, or (at your option) any later version.
  15  *
  16  * This program is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19  * GNU General Public License for more details.
  20  *
  21  * You should have received a copy of the GNU General Public License
  22  * along with this program; if not, write to the Free Software
  23  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  24  */
  25
  26 #ifndef _SMB_H
  27 #define _SMB_H
  28
  29 extern gboolean sid_name_snooping;
  30
  31 /* SMB command codes, from the SNIA CIFS spec. */
  32 extern const value_string smb_cmd_vals[];
  33 extern const value_string trans2_cmd_vals[];
  34 extern const value_string nt_cmd_vals[];
  35
  36 #define SMB_COM_CREATE_DIRECTORY                0x00
  37 #define SMB_COM_DELETE_DIRECTORY                0x01
  38 #define SMB_COM_OPEN                            0x02
  39 #define SMB_COM_CREATE                          0x03
  40 #define SMB_COM_CLOSE                           0x04
  41 #define SMB_COM_FLUSH                           0x05
  42 #define SMB_COM_DELETE                          0x06
  43 #define SMB_COM_RENAME                          0x07
  44 #define SMB_COM_QUERY_INFORMATION               0x08
  45 #define SMB_COM_SET_INFORMATION                 0x09
  46 #define SMB_COM_READ                            0x0A
  47 #define SMB_COM_WRITE                           0x0B
  48 #define SMB_COM_LOCK_BYTE_RANGE                 0x0C
  49 #define SMB_COM_UNLOCK_BYTE_RANGE               0x0D
  50 #define SMB_COM_CREATE_TEMPORARY                0x0E
  51 #define SMB_COM_CREATE_NEW                      0x0F
  52 #define SMB_COM_CHECK_DIRECTORY                 0x10
  53 #define SMB_COM_PROCESS_EXIT                    0x11
  54 #define SMB_COM_SEEK                            0x12
  55 #define SMB_COM_LOCK_AND_READ                   0x13
  56 #define SMB_COM_WRITE_AND_UNLOCK                0x14
  57 #define SMB_COM_READ_RAW                        0x1A
  58 #define SMB_COM_READ_MPX                        0x1B
  59 #define SMB_COM_READ_MPX_SECONDARY              0x1C
  60 #define SMB_COM_WRITE_RAW                       0x1D
  61 #define SMB_COM_WRITE_MPX                       0x1E
  62 #define SMB_COM_WRITE_MPX_SECONDARY             0x1F
  63 #define SMB_COM_WRITE_COMPLETE                  0x20
  64 #define SMB_COM_QUERY_SERVER                    0x21
  65 #define SMB_COM_SET_INFORMATION2                0x22
  66 #define SMB_COM_QUERY_INFORMATION2              0x23
  67 #define SMB_COM_LOCKING_ANDX                    0x24
  68 #define SMB_COM_TRANSACTION                     0x25
  69 #define SMB_COM_TRANSACTION_SECONDARY           0x26
  70 #define SMB_COM_IOCTL                           0x27
  71 #define SMB_COM_IOCTL_SECONDARY                 0x28
  72 #define SMB_COM_COPY                            0x29
  73 #define SMB_COM_MOVE                            0x2A
  74 #define SMB_COM_ECHO                            0x2B
  75 #define SMB_COM_WRITE_AND_CLOSE                 0x2C
  76 #define SMB_COM_OPEN_ANDX                       0x2D
  77 #define SMB_COM_READ_ANDX                       0x2E
  78 #define SMB_COM_WRITE_ANDX                      0x2F
  79 #define SMB_COM_NEW_FILE_SIZE                   0x30
  80 #define SMB_COM_CLOSE_AND_TREE_DISC             0x31
  81 #define SMB_COM_TRANSACTION2                    0x32
  82 #define SMB_COM_TRANSACTION2_SECONDARY          0x33
  83 #define SMB_COM_FIND_CLOSE2                     0x34
  84 #define SMB_COM_FIND_NOTIFY_CLOSE               0x35
  85 /* Used by Xenix/Unix           0x60-0x6E */
  86 #define SMB_COM_TREE_CONNECT                    0x70
  87 #define SMB_COM_TREE_DISCONNECT                 0x71
  88 #define SMB_COM_NEGOTIATE                       0x72
  89 #define SMB_COM_SESSION_SETUP_ANDX              0x73
  90 #define SMB_COM_LOGOFF_ANDX                     0x74
  91 #define SMB_COM_TREE_CONNECT_ANDX               0x75
  92 #define SMB_COM_QUERY_INFORMATION_DISK          0x80
  93 #define SMB_COM_SEARCH                          0x81
  94 #define SMB_COM_FIND                            0x82
  95 #define SMB_COM_FIND_UNIQUE                     0x83
  96 #define SMB_COM_FIND_CLOSE                      0x84
  97 #define SMB_COM_NT_TRANSACT                     0xA0
  98 #define SMB_COM_NT_TRANSACT_SECONDARY           0xA1
  99 #define SMB_COM_NT_CREATE_ANDX                  0xA2
 100 #define SMB_COM_NT_CANCEL                       0xA4
 101 #define SMB_COM_NT_RENAME                       0xA5
 102 #define SMB_COM_OPEN_PRINT_FILE                 0xC0
 103 #define SMB_COM_WRITE_PRINT_FILE                0xC1
 104 #define SMB_COM_CLOSE_PRINT_FILE                0xC2
 105 #define SMB_COM_GET_PRINT_QUEUE                 0xC3
 106 #define SMB_COM_READ_BULK                       0xD8
 107 #define SMB_COM_WRITE_BULK                      0xD9
 108 #define SMB_COM_WRITE_BULK_DATA                 0xDA
 109
 110 /* Error codes */
 111
 112 #define SMB_SUCCESS 0x00  /* All OK */
 113 #define SMB_ERRDOS  0x01  /* DOS based error */
 114 #define SMB_ERRSRV  0x02  /* server error, network file manager */
 115 #define SMB_ERRHRD  0x03  /* Hardware style error */
 116 #define SMB_ERRCMD  0x04  /* Not an SMB format command */
 117
 118 /* SMB X/Open error codes for the ERRDOS error class */
 119 #define SMBE_badfunc 1             /* Invalid function (or system call) */
 120 #define SMBE_badfile 2             /* File not found (pathname error) */
 121 #define SMBE_badpath 3             /* Directory not found */
 122 #define SMBE_nofids 4              /* Too many open files */
 123 #define SMBE_noaccess 5            /* Access denied */
 124 #define SMBE_badfid 6              /* Invalid fid */
 125 #define SMBE_badmcb 7              /* Memory control blocks destroyed */
 126 #define SMBE_nomem 8               /* Out of memory */
 127 #define SMBE_badmem 9              /* Invalid memory block address */
 128 #define SMBE_badenv 10             /* Invalid environment */
 129 #define SMBE_badformat 11          /* Invalid format */
 130 #define SMBE_badaccess 12          /* Invalid open mode */
 131 #define SMBE_baddata 13            /* Invalid data (only from ioctl call) */
 132 #define SMBE_res 14
 133 #define SMBE_baddrive 15           /* Invalid drive */
 134 #define SMBE_remcd 16              /* Attempt to delete current directory */
 135 #define SMBE_diffdevice 17         /* rename/move across different filesystems */
 136 #define SMBE_nofiles 18            /* no more files found in file search */
 137 #define SMBE_badshare 32           /* Share mode on file conflict with open mode */
 138 #define SMBE_lock 33               /* Lock request conflicts with existing lock */
 139 #define SMBE_unsup 50              /* Request unsupported, returned by Win 95, RJS 20Jun98 */
 140 #define SMBE_nosuchshare 67        /* Share does not exits */
 141 #define SMBE_filexists 80          /* File in operation already exists */
 142 #define SMBE_invalidparam 87       /* Invalid parameter */
 143 #define SMBE_cannotopen 110        /* Cannot open the file specified */
 144 #define SMBE_insufficientbuffer 122/* Insufficient buffer size */
 145 #define SMBE_invalidname 123       /* Invalid name */
 146 #define SMBE_unknownlevel 124      /* Unknown info level */
 147 #define SMBE_alreadyexists 183     /* File already exists */
 148 #define SMBE_badpipe 230           /* Named pipe invalid */
 149 #define SMBE_pipebusy 231          /* All instances of pipe are busy */
 150 #define SMBE_pipeclosing 232       /* named pipe close in progress */
 151 #define SMBE_notconnected 233      /* No process on other end of named pipe */
 152 #define SMBE_moredata 234          /* More data to be returned */
 153 #define SMBE_nomoreitems 259       /* No more items */
 154 #define SMBE_baddirectory 267      /* Invalid directory name in a path. */
 155 #define SMBE_eas_didnt_fit 275     /* Extended attributes didn't fit */
 156 #define SMBE_eas_nsup 282          /* Extended attributes not supported */
 157 #define SMBE_notify_buf_small 1022 /* Buffer too small to return change notify. */
 158 #define SMBE_serverunavailable 1722/* Server unavailable */
 159 #define SMBE_unknownipc 2142
 160 #define SMBE_noipc 66              /* don't support ipc */
 161
 162 /* These errors seem to be only returned by the NT printer driver system */
 163
 164 #define SMBE_invalidowner 1307  /* Invalid security descriptor owner */
 165 #define SMBE_invalidsecuritydescriptor 1338 /* Invalid security descriptor */
 166 #define SMBE_unknownprinterdriver 1797 /* Unknown printer driver */
 167 #define SMBE_invalidprintername 1801   /* Invalid printer name */
 168 #define SMBE_printeralreadyexists 1802 /* Printer already exists */
 169 #define SMBE_invaliddatatype 1804      /* Invalid datatype */
 170 #define SMBE_invalidenvironment 1805   /* Invalid environment */
 171 #define SMBE_invalidformsize    1903   /* Invalid form size */
 172 #define SMBE_printerdriverinuse 3001   /* Printer driver in use */
 173
 174 /* Error codes for the ERRSRV class */
 175
 176 #define SMBE_error 1               /* Non specific error code */
 177 #define SMBE_badpw 2               /* Bad password */
 178 #define SMBE_badtype 3             /* reserved */
 179 #define SMBE_access 4              /* No permissions to do the requested operation */
 180 #define SMBE_invnid 5              /* tid invalid */
 181 #define SMBE_invnetname 6          /* Invalid servername */
 182 #define SMBE_invdevice 7           /* Invalid device */
 183 #define SMBE_qfull 49              /* Print queue full */
 184 #define SMBE_qtoobig 50            /* Queued item too big */
 185 #define SMBE_qeof 51               /* EOF in print queue dump */
 186 #define SMBE_invpfid 52            /* Invalid print file in smb_fid */
 187 #define SMBE_smbcmd 64             /* Unrecognised command */
 188 #define SMBE_srverror 65           /* smb server internal error */
 189 #define SMBE_filespecs 67          /* fid and pathname invalid combination */
 190 #define SMBE_badlink 68
 191 #define SMBE_badpermits 69         /* Access specified for a file is not valid */
 192 #define SMBE_badpid 70
 193 #define SMBE_setattrmode 71        /* attribute mode invalid */
 194 #define SMBE_paused 81             /* Message server paused */
 195 #define SMBE_msgoff 82             /* Not receiving messages */
 196 #define SMBE_noroom 83             /* No room for message */
 197 #define SMBE_rmuns 87              /* too many remote usernames */
 198 #define SMBE_timeout 88            /* operation timed out */
 199 #define SMBE_noresource  89        /* No resources currently available for request. */
 200 #define SMBE_toomanyuids 90        /* too many userids */
 201 #define SMBE_baduid 91             /* bad userid */
 202 #define SMBE_useMPX 250            /* temporarily unable to use raw mode, use MPX mode */
 203 #define SMBE_useSTD 251            /* temporarily unable to use raw mode, use standard mode */
 204 #define SMBE_contMPX 252           /* resume MPX mode */
 205 #define SMBE_badPW 253             /* Check this out ... */
 206 #define SMBE_nosupport 0xFFFF
 207 #define SMBE_unknownsmb 22         /* from NT 3.5 response */
 208
 209 /* Error codes for the ERRHRD class */
 210
 211 #define SMBE_nowrite 19     /* read only media */
 212 #define SMBE_badunit 20     /* Unknown device */
 213 #define SMBE_notready 21    /* Drive not ready */
 214 #define SMBE_badcmd 22      /* Unknown command */
 215 #define SMBE_data 23        /* Data (CRC) error */
 216 #define SMBE_badreq 24      /* Bad request structure length */
 217 #define SMBE_seek 25        /* Seek error */
 218 #define SMBE_badmedia 26    /* Unknown media type */
 219 #define SMBE_badsector 27   /* Sector not found */
 220 #define SMBE_nopaper 28     /* Printer out of paper */
 221 #define SMBE_write 29       /* Write fault */
 222 #define SMBE_read 30        /* Read fault */
 223 #define SMBE_general 31     /* General failure */
 224 #define SMBE_badshare 32    /* An open conflicts with an existing open */
 225 #define SMBE_lock 33        /* Lock conflict or invalid mode, or unlock of
 226                                lock held by another process */
 227 #define SMBE_wrongdisk 34   /* The wrong disk was found in a drive */
 228 #define SMBE_FCBunavail 35  /* No FCBs are available to process request */
 229 #define SMBE_sharebufexc 36 /* A sharing buffer has been exceeded */
 230 #define SMBE_diskfull 39
 231
 232 /* the information we need to keep around for NT transatcion commands */
 233 typedef struct {
 234         int subcmd;
 235 } smb_nt_transact_info_t;
 236
 237 /* the information we need to keep around for transaction2 commands */
 238 typedef struct {
 239         int subcmd;
 240         int info_level;
 241         gboolean resume_keys; /* if "return resume" keys set in T2 FIND_FIRST request */
 242 } smb_transact2_info_t;
 243
 244 /*
 245  * The information we need to save about a request in order to show the
 246  * frame number of the request in the dissection of the reply.
 247  */
 248 #define SMB_SIF_TID_IS_IPC      0x0001
 249 typedef struct {
 250         guint32 frame_req, frame_res;
 251         nstime_t req_time;
 252         guint16 flags;
 253         guint8 cmd;
 254         void *extra_info;
 255 } smb_saved_info_t;
 256
 257 /*
 258  * The information we need to save about a Transaction request in order
 259  * to dissect the reply; this includes information for use by the
 260  * Remote API and Mailslot dissectors.
 261  * XXX - have an additional data structure hung off of this by the
 262  * subdissectors?
 263  */
 264 typedef struct {
 265         int subcmd;
 266         int trans_subcmd;
 267         int function;
 268         int fid;
 269         guint16 lanman_cmd;
 270         guchar *param_descrip;  /* Keep these descriptors around */
 271         guchar *data_descrip;
 272         guchar *aux_data_descrip;
 273         int info_level;
 274 } smb_transact_info_t;
 275
 276 /*
 277  * Subcommand type.
 278  */
 279 #define TRANSACTION_PIPE        0
 280 #define TRANSACTION_MAILSLOT    1
 281
 282 /* these are defines used to represent different types of TIDs.
 283    dont use the value 0 for any of these */
 284 #define TID_NORMAL      1
 285 #define TID_IPC         2
 286
 287 /* this is the structure which is associated with each conversation */
 288 typedef struct conv_tables {
 289         /* these two tables are used to match requests with responses */
 290         GHashTable *unmatched;
 291         GHashTable *matched;
 292
 293         /* This table is used to track TID->services for a conversation */
 294         GHashTable *tid_service;
 295         gboolean raw_ntlmssp;   /* Do extended security exc use raw ntlmssp */
 296 } conv_tables_t;
 297
 298 typedef struct smb_info {
 299   guint8 cmd;
 300   int tid, pid, uid, mid;
 301   gboolean unicode;             /* Are strings in this SMB Unicode? */
 302   gboolean request;             /* Is this a request? */
 303   gboolean unidir;
 304   int info_level;
 305   int info_count;
 306   smb_saved_info_t *sip;        /* smb_saved_info_t, if any, for this */
 307   conv_tables_t *ct;
 308 } smb_info_t;
 309
 310 /*
 311  * Show file data for a read or write.
 312  */
 313 extern int dissect_file_data(tvbuff_t *tvb, proto_tree *tree, int offset,
 314     guint16 bc, guint16 datalen);
 315
 316 /*
 317  * Add a FID to the protocol tree and the Info column.
 318  */
 319 extern void add_fid(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree,
 320     int offset, int len, guint16 fid);
 321
 322 /*
 323  * Dissect named pipe state information.
 324  */
 325 extern int dissect_ipc_state(tvbuff_t *tvb, proto_tree *parent_tree,
 326     int offset, gboolean setstate);
 327
 328 extern gboolean smb_dcerpc_reassembly;
 329
 330 /*
 331  * NT and DOS error codes used by other dissectors.
 332  */
 333 extern const value_string NT_errors[];
 334 extern const value_string DOS_errors[];
 335 extern const value_string ms_country_codes[];
 336
 337 /*
 338  * Access mask values
 339  */
 340
 341 /* Generic rights */
 342
 343 #define GENERIC_RIGHTS_MASK    0xF0000000
 344
 345 #define GENERIC_ALL_ACCESS     0x10000000
 346 #define GENERIC_EXECUTE_ACCESS 0x20000000
 347 #define GENERIC_WRITE_ACCESS   0x40000000
 348 #define GENERIC_READ_ACCESS    0x80000000
 349
 350 /* Misc/reserved */
 351
 352 #define ACCESS_SACL_ACCESS     0x00800000
 353 #define SYSTEM_SECURITY_ACCESS 0x01000000
 354 #define MAXIMUM_ALLOWED_ACCESS 0x02000000
 355
 356 /* Standard rights */
 357
 358 #define STANDARD_RIGHTS_MASK 0x00FF0000
 359
 360 #define DELETE_ACCESS        0x00010000
 361 #define READ_CONTROL_ACCESS  0x00020000
 362 #define WRITE_DAC_ACCESS     0x00040000
 363 #define WRITE_OWNER_ACCESS   0x00080000
 364 #define SYNCHRONIZE_ACCESS   0x00100000
 365
 366 /* Specific rights */
 367
 368 #define SPECIFIC_RIGHTS_MASK 0x0000FFFF /* Specific rights defined per-object */
 369
 370 #endif