@sharelist/node-smb-server/lib/smb/cmd/nt_cancel.js

Sharelist SMB Server Implementation Base On node-smb-server

/*
 *  Copyright 2015 Adobe Systems Incorporated. All rights reserved.
 *  This file is licensed to you under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License. You may obtain a copy
 *  of the License at http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software distributed under
 *  the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
 *  OF ANY KIND, either express or implied. See the License for the specific language
 *  governing permissions and limitations under the License.
 */

'use strict';

var put = require('put');
var logger = require('winston').loggers.get('smb');

var SMB = require('../constants');

/**
 * SMB_COM_NT_CANCEL (0xA4): This command allows a client to request that a currently pending request be canceled.
 *
 * @param {Object} msg - an SMB message object
 * @param {Number} commandId - the command id
 * @param {Buffer} commandParams - the command parameters
 * @param {Buffer} commandData - the command data
 * @param {Number} commandParamsOffset - the command parameters offset within the SMB
 * @param {Number} commandDataOffset - the command data offset within the SMB
 * @param {Object} connection - an SMBConnection instance
 * @param {Object} server - an SMBServer instance
 * @param {Function} cb callback called with the command's result
 * @param {Object} cb.result - an object with the command's result params and data
 *                             or null if the handler already sent the response and
 *                             no further processing is required by the caller
 * @param {Number} cb.result.status
 * @param {Buffer} cb.result.params
 * @param {Buffer} cb.result.data
 */
function handle(msg, commandId, commandParams, commandData, commandParamsOffset, commandDataOffset, connection, server, cb) {

  logger.debug('[%s] tid: %d, uid: %d, mid: %d, pid: %d', SMB.COMMAND_TO_STRING[commandId].toUpperCase(), msg.header.tid, msg.header.uid, msg.header.mid, msg.header.pid);

  var tree = server.getTree(msg.header.tid);
  if (tree) {
    tree.cancelChangeListener(msg.header.mid);
  }

  // "The server MUST NOT send a corresponding response for this request."
  // no further processing required by the caller
  process.nextTick(function () { cb(null); });
}

module.exports = handle;