nasl_smb.h File Reference

Protos for NASL SMB API. More...

#include "nasl_lex_ctxt.h"
#include "nasl_tree.h"

Include dependency graph for nasl_smb.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
tree_cell *	nasl_smb_versioninfo (lex_ctxt *lexic)
	Get a version string of the SMB implementation.
tree_cell *	nasl_smb_connect (lex_ctxt *lexic)
	Connect to SMB service and return a handle for it.
tree_cell *	nasl_smb_close (lex_ctxt *lexic)
	Close SMB service handle.
tree_cell *	nasl_smb_file_SDDL (lex_ctxt *lexic)
	Obtain Security Descriptor in SDDL format.
tree_cell *	nasl_smb_file_owner_sid (lex_ctxt *lexic)
	Obtain File Owner SID.
tree_cell *	nasl_smb_file_group_sid (lex_ctxt *lexic)
	Obtain File Group SID.
tree_cell *	nasl_smb_file_trustee_rights (lex_ctxt *lexic)
	Obtain File Trustee SID with Access Mask.
tree_cell *	nasl_win_cmd_exec (lex_ctxt *lexic)
	Execute the command in windows.

Detailed Description

Protos for NASL SMB API.

This file contains the protos for nasl_smb.c

Definition in file nasl_smb.h.

Function Documentation

nasl_smb_close()

tree_cell * nasl_smb_close

(

lex_ctxt *

lexic

)

Close SMB service handle.

Parameters

[in]

lexic

Lexical context of NASL interpreter.

Returns

NULL in case of a serious problem. Else returns a treecell with integer == 1.

Retrieves local variable "smb_handle" from the lexical context and closes the respective handle.

Definition at line 131 of file nasl_smb.c.

{
  SMB_HANDLE handle = (SMB_HANDLE) get_int_var_by_name (lexic, "smb_handle", 0);
  int ret;
  tree_cell *retc;
 
  retc = alloc_typed_cell (CONST_INT);
 
  ret = smb_close (handle);
  if (ret == 0)
    {
      retc->x.i_val = 1;
      return retc;
    }
  else
    return NULL;
}

References alloc_typed_cell(), CONST_INT, get_int_var_by_name(), TC::i_val, smb_close(), and TC::x.

Here is the call graph for this function:

nasl_smb_connect()

tree_cell * nasl_smb_connect

(

lex_ctxt *

lexic

)

Connect to SMB service and return a handle for it.

Parameters

[in]

lexic

Lexical context of NASL interpreter.

Returns

NULL in case the connection could not be established. Else a tree_cell with the handle.

Retrieves local variables "host", "username", "password" and "share" from the lexical context, performs and connects to this given SMB service returning a handle for the service as integer.

Definition at line 76 of file nasl_smb.c.

{
  struct script_infos *script_infos = lexic->script_infos;
  struct in6_addr *host = plug_get_host_ip (script_infos);
  char *ip;
  char *username = get_str_var_by_name (lexic, "username");
  char *password = get_str_var_by_name (lexic, "password");
  char *share = get_str_var_by_name (lexic, "share");
 
  tree_cell *retc;
  SMB_HANDLE handle;
  int value;
 
  if ((host == NULL) || (username == NULL) || (password == NULL)
      || (share == NULL))
    {
      g_message ("nasl_smb_connect: Invalid input arguments");
      return NULL;
    }
 
  ip = addr6_as_str (host);
  if ((strlen (password) == 0) || (strlen (username) == 0) || (strlen (ip) == 0)
      || (strlen (share) == 0))
    {
      g_message ("nasl_smb_connect: Invalid input arguments");
      g_free (ip);
      return NULL;
    }
 
  retc = alloc_typed_cell (CONST_INT);
  value = smb_connect (ip, share, username, password, &handle);
  g_free (ip);
 
  if (value == -1)
    {
      g_message ("nasl_smb_connect: SMB Connect failed");
      return NULL;
    }
 
  retc->x.i_val = handle;
  return retc;
}

References alloc_typed_cell(), CONST_INT, get_str_var_by_name(), TC::i_val, plug_get_host_ip(), struct_lex_ctxt::script_infos, smb_connect(), and TC::x.

Here is the call graph for this function:

nasl_smb_file_group_sid()

tree_cell * nasl_smb_file_group_sid

(

lex_ctxt *

lexic

)

Obtain File Group SID.

Parameters

[in]

lexic

Lexical context of NASL interpreter.

Returns

NULL in case of problem. Else returns a treecell with Group SID string

Retrieves local variable "smb_handle" and "filename" from the lexical context and perform file rights query.

Definition at line 247 of file nasl_smb.c.

{
  SMB_HANDLE handle = (SMB_HANDLE) get_int_var_by_name (lexic, "smb_handle", 0);
  char *filename = get_str_var_by_name (lexic, "filename");
 
  if (!filename)
    {
      g_message ("smb_file_group_sid failed: Invalid filename");
      return NULL;
    }
 
  if (!handle)
    {
      g_message ("smb_file_group_sid failed: Invalid smb_handle");
      return NULL;
    }
 
  tree_cell *retc;
  char *buffer;
 
  buffer = smb_file_GroupSID (handle, filename);
 
  if (buffer == NULL)
    return NULL;
 
  retc = alloc_typed_cell (CONST_DATA);
  retc->size = strlen (buffer);
  retc->x.str_val = strdup (buffer);
  return retc;
}

References alloc_typed_cell(), CONST_DATA, get_int_var_by_name(), get_str_var_by_name(), TC::size, smb_file_GroupSID(), TC::str_val, and TC::x.

Here is the call graph for this function:

nasl_smb_file_owner_sid()

tree_cell * nasl_smb_file_owner_sid

(

lex_ctxt *

lexic

)

Obtain File Owner SID.

Parameters

[in]

lexic

Lexical context of NASL interpreter.

Returns

NULL in case of problem. Else returns a treecell with Owner SID string

Retrieves local variable "smb_handle" and "filename" from the lexical context and perform file rights query.

Definition at line 204 of file nasl_smb.c.

{
  SMB_HANDLE handle = (SMB_HANDLE) get_int_var_by_name (lexic, "smb_handle", 0);
  char *filename = get_str_var_by_name (lexic, "filename");
 
  if (!filename)
    {
      g_message ("smb_file_owner_sid failed: Invalid filename");
      return NULL;
    }
 
  if (!handle)
    {
      g_message ("smb_file_owner_sid failed: Invalid smb_handle");
      return NULL;
    }
 
  tree_cell *retc;
  char *buffer;
 
  buffer = smb_file_OwnerSID (handle, filename);
 
  if (buffer == NULL)
    return NULL;
 
  retc = alloc_typed_cell (CONST_DATA);
  retc->size = strlen (buffer);
  retc->x.str_val = strdup (buffer);
  return retc;
}

References alloc_typed_cell(), CONST_DATA, get_int_var_by_name(), get_str_var_by_name(), TC::size, smb_file_OwnerSID(), TC::str_val, and TC::x.

Here is the call graph for this function:

nasl_smb_file_SDDL()

tree_cell * nasl_smb_file_SDDL

(

lex_ctxt *

lexic

)

Obtain Security Descriptor in SDDL format.

Parameters

[in]

lexic

Lexical context of NASL interpreter.

Returns

NULL in case of problem. Else returns a treecell with SDDL string

Retrieves local variable "smb_handle" and "filename" from the lexical context and perform file rights query.

Definition at line 161 of file nasl_smb.c.

{
  SMB_HANDLE handle = (SMB_HANDLE) get_int_var_by_name (lexic, "smb_handle", 0);
  char *filename = get_str_var_by_name (lexic, "filename");
 
  if (!filename)
    {
      g_message ("smb_file_SDDL failed: Invalid filename");
      return NULL;
    }
 
  if (!handle)
    {
      g_message ("smb_file_SDDL failed: Invalid smb_handle");
      return NULL;
    }
 
  tree_cell *retc;
  char *buffer = NULL;
 
  buffer = smb_file_SDDL (handle, filename);
 
  if (buffer == NULL)
    return NULL;
 
  retc = alloc_typed_cell (CONST_DATA);
  retc->size = strlen (buffer);
  retc->x.str_val = strdup (buffer);
  return retc;
}

References alloc_typed_cell(), CONST_DATA, get_int_var_by_name(), get_str_var_by_name(), TC::size, smb_file_SDDL(), TC::str_val, and TC::x.

Here is the call graph for this function:

nasl_smb_file_trustee_rights()

tree_cell * nasl_smb_file_trustee_rights

(

lex_ctxt *

lexic

)

Obtain File Trustee SID with Access Mask.

Parameters

[in]

lexic

Lexical context of NASL interpreter.

Returns

NULL in case of problem. Else returns a treecell with Trustee SID and Access Mask string

Retrieves local variable "smb_handle" and "filename" from the lexical context and perform file rights query.

Definition at line 290 of file nasl_smb.c.

{
  SMB_HANDLE handle = (SMB_HANDLE) get_int_var_by_name (lexic, "smb_handle", 0);
  char *filename = get_str_var_by_name (lexic, "filename");
 
  if (!filename)
    {
      g_message ("smb_file_trustee_rights failed: Invalid filename");
      return NULL;
    }
 
  if (!handle)
    {
      g_message ("smb_file_trustee_rights failed: Invalid smb_handle");
      return NULL;
    }
 
  tree_cell *retc;
  char *buffer;
 
  buffer = smb_file_TrusteeRights (handle, filename);
 
  if (buffer == NULL)
    return NULL;
 
  retc = alloc_typed_cell (CONST_DATA);
  retc->size = strlen (buffer);
  retc->x.str_val = strdup (buffer);
  return retc;
}

References alloc_typed_cell(), CONST_DATA, get_int_var_by_name(), get_str_var_by_name(), TC::size, smb_file_TrusteeRights(), TC::str_val, and TC::x.

Here is the call graph for this function:

nasl_smb_versioninfo()

tree_cell * nasl_smb_versioninfo

(

lex_ctxt *

lexic

)

Get a version string of the SMB implementation.

Parameters

[in]

lexic

Lexical context of NASL interpreter.

Returns

NULL in case no implementation is present. Else a tree_cell with the version as string.

Definition at line 48 of file nasl_smb.c.

{
  char *version = smb_versioninfo ();
  tree_cell *retc;
  (void) lexic;
 
  if (!version)
    return NULL;
 
  retc = alloc_typed_cell (CONST_DATA);
  retc->x.str_val = strdup (version);
  retc->size = strlen (version);
  return retc;
}

References alloc_typed_cell(), CONST_DATA, TC::size, smb_versioninfo(), TC::str_val, and TC::x.

Here is the call graph for this function:

nasl_win_cmd_exec()

tree_cell * nasl_win_cmd_exec

(

lex_ctxt *

lexic

)

Execute the command in windows.

Parameters

[in]

lexic

Lexical context of NASL interpreter.

Returns

NULL if the query fails. Else a tree_cell with the command execution result.

Retrieves local variables "cmd" from the lexical context, performs the windows command execution operation returning the result.

Definition at line 335 of file nasl_smb.c.

{
  struct script_infos *script_infos = lexic->script_infos;
  struct in6_addr *host = plug_get_host_ip (script_infos);
  char *ip, *argv[4], *unicode, target[2048], *c;
  tree_cell *retc;
  GString *string = NULL;
  int sout, ret;
  GError *err = NULL;
 
  IMPORT (username);
  IMPORT (password);
  IMPORT (cmd);
 
  if ((host == NULL) || (username == NULL) || (password == NULL)
      || (cmd == NULL))
    {
      g_message ("win_cmd_exec: Invalid input arguments");
      return NULL;
    }
 
  ip = addr6_as_str (host);
  if ((strlen (password) == 0) || (strlen (username) == 0) || strlen (ip) == 0)
    {
      g_message ("win_cmd_exec: Invalid input arguments");
      g_free (ip);
      return NULL;
    }
 
  /* wmiexec.py uses domain/username format. */
  if ((c = strchr (username, '\\')))
    *c = '/';
  argv[0] = "impacket-wmiexec";
  snprintf (target, sizeof (target), "%s:%s@%s", username, password, ip);
  argv[1] = target;
  argv[2] = cmd;
  argv[3] = NULL;
  ret = g_spawn_async_with_pipes (NULL, argv, NULL, G_SPAWN_SEARCH_PATH, NULL,
                                  NULL, NULL, NULL, &sout, NULL, &err);
  g_free (ip);
  if (ret == FALSE)
    {
      g_warning ("win_cmd_exec: %s", err ? err->message : "Error");
      if (err)
        g_error_free (err);
      return NULL;
    }
 
  string = g_string_new ("");
  while (1)
    {
      char buf[4096];
      size_t bytes;
 
      bytes = read (sout, buf, sizeof (buf));
      if (!bytes)
        break;
      else if (bytes > 0)
        g_string_append_len (string, buf, bytes);
      else
        {
          g_warning ("win_cmd_exec: %s", strerror (errno));
          g_string_free (string, TRUE);
          close (sout);
          return NULL;
        }
    }
  close (sout);
 
  if (g_str_has_prefix (string->str, "[-]"))
    {
      g_warning ("win_cmd_exec: %s", string->str);
      g_string_free (string, TRUE);
      return NULL;
    }
  else if ((unicode = strstr (string->str, "\xff\xfe")))
    {
      /* UTF-16 case. */
      size_t length, diff;
      err = NULL;
      char *tmp;
 
      diff = unicode - string->str + 1;
      tmp = g_convert (unicode + 2, string->len - diff, "UTF-8", "UTF-16", NULL,
                       &length, &err);
      if (!tmp)
        {
          g_warning ("win_cmd_exec: %s", err->message);
          g_string_free (string, TRUE);
          g_error_free (err);
          return NULL;
        }
      g_free (string->str);
      string->len = length;
      string->str = tmp;
    }
 
  retc = alloc_typed_cell (CONST_DATA);
  retc->x.str_val = string->str;
  retc->size = string->len;
  return retc;
}

References alloc_typed_cell(), CONST_DATA, IMPORT, length, plug_get_host_ip(), struct_lex_ctxt::script_infos, TC::size, TC::str_val, and TC::x.

Here is the call graph for this function: