Files

331 lines
9.1 KiB
Python

# Copyright (C) 2016-2018 Cuckoo Foundation.
# This file is part of Cuckoo Sandbox - http://www.cuckoosandbox.org
# See the file 'docs/LICENSE' for copying permission.
import ctypes
import mock
import os
import pytest
import subprocess
import sys
import tempfile
import time
from cuckoo.common.exceptions import CuckooStartupError
from cuckoo.common.files import Files
from cuckoo.common.structures import Structure
from cuckoo.main import cuckoo_create
from cuckoo.misc import (
dispatch, cwd, set_cwd, getuser, mkdir, Popen, drop_privileges, make_list,
HAVE_PWD, is_linux, is_windows, is_macosx, decide_cwd, Pidfile,
format_command
)
def return_value(value):
return value
def sleep2(value):
time.sleep(2)
return value
def test_dispatch():
assert dispatch(return_value, (1,)) == 1
assert dispatch(return_value, ("foo",)) == "foo"
assert dispatch(sleep2, (2,)) == 2
assert dispatch(sleep2, (2,), timeout=1) is None
with pytest.raises(RuntimeError):
dispatch(None, args=None)
with pytest.raises(RuntimeError):
dispatch(None, kwargs=None)
with pytest.raises(RuntimeError):
dispatch(None, process=False)
def test_cwd():
set_cwd("/tmp/foo")
assert cwd() == "/tmp/foo"
assert cwd("a") == os.path.join("/tmp/foo", "a")
assert cwd("a", "b") == os.path.join("/tmp/foo", "a", "b")
set_cwd("/home/user/.cuckoo", "~/.cuckoo")
assert cwd(raw=True) == "~/.cuckoo"
assert cwd(root=True) == "/home/user/.cuckoo"
assert cwd("dump.pcap", analysis=1234) == os.path.join(
"/home/user/.cuckoo", "storage", "analyses", "1234", "dump.pcap"
)
assert os.path.exists(cwd("guids.txt", private=True))
with pytest.raises(RuntimeError):
cwd("foo", private=False)
with pytest.raises(RuntimeError):
cwd("foo", raw=False)
with pytest.raises(RuntimeError):
cwd("foo", root=False)
with pytest.raises(RuntimeError):
cwd("foo", analysis=None)
@pytest.mark.skipif(not HAVE_PWD, reason="This test is not for Windows")
def test_getuser():
# TODO This probably doesn't work on all platforms.
assert getuser() == subprocess.check_output(["id", "-un"]).strip()
def test_mkdir():
dirpath = tempfile.mkdtemp()
assert os.path.isdir(dirpath)
mkdir(dirpath)
assert os.path.isdir(dirpath)
dirpath = tempfile.mktemp()
assert not os.path.exists(dirpath)
mkdir(dirpath)
assert os.path.isdir(dirpath)
@pytest.mark.skipif("sys.platform != 'win32'")
def test_is_windows():
assert is_windows() is True
assert is_linux() is False
assert is_macosx() is False
@pytest.mark.skipif("sys.platform != 'darwin'")
def test_is_macosx():
assert is_windows() is False
assert is_linux() is False
assert is_macosx() is True
@pytest.mark.skipif("sys.platform != 'linux2'")
def test_is_linux():
assert is_windows() is False
assert is_linux() is True
assert is_macosx() is False
def test_platforms():
"""Ensure that the above unit tests are complete (for our supported
platforms)."""
assert sys.platform in ("win32", "linux2", "darwin")
def test_popen():
"""Ensure that Popen is working properly."""
with mock.patch("subprocess.Popen") as p:
p.return_value = None
Popen(["foo", "bar"])
p.assert_called_once_with(["foo", "bar"])
with mock.patch("subprocess.Popen") as p:
p.return_value = None
Popen(
["foo", "bar"], close_fds=True,
stdout=subprocess.PIPE, stderr=subprocess.PIPE
)
if is_windows():
p.assert_called_once_with(
["foo", "bar"],
stdout=subprocess.PIPE, stderr=subprocess.PIPE
)
else:
p.assert_called_once_with(
["foo", "bar"], close_fds=True,
stdout=subprocess.PIPE, stderr=subprocess.PIPE
)
# Test that the method actually works.
p = Popen("echo 123", stdout=subprocess.PIPE, shell=True)
out, err = p.communicate()
assert out.strip() == "123" and not err
# The following would normally throw an exception on Windows.
p = Popen("echo 1234", close_fds=True, stdout=subprocess.PIPE, shell=True)
out, err = p.communicate()
assert out.strip() == "1234" and not err
def test_decide_cwd():
orig_cuckoo_cwd = os.environ.pop("CUCKOO_CWD", None)
orig_cuckoo = os.environ.pop("CUCKOO", None)
dirpath1 = tempfile.mkdtemp()
dirpath2 = tempfile.mkdtemp()
dirpath3 = tempfile.mkdtemp()
assert decide_cwd(dirpath1) == dirpath1
assert decide_cwd() == os.path.abspath(os.path.expanduser("~/.cuckoo"))
curdir = os.getcwd()
os.chdir(dirpath2)
open(".cwd", "wb").write("A"*40)
assert decide_cwd() == os.path.abspath(".")
os.chdir(curdir)
os.environ["CUCKOO"] = dirpath2
assert decide_cwd(dirpath1) == dirpath1
assert decide_cwd() == dirpath2
os.environ["CUCKOO_CWD"] = dirpath3
assert decide_cwd(dirpath1) == dirpath1
assert decide_cwd() == dirpath3
with pytest.raises(CuckooStartupError) as e:
decide_cwd(tempfile.mktemp(), exists=True)
e.match("is not present")
with pytest.raises(CuckooStartupError) as e:
decide_cwd(dirpath1, exists=True)
e.match("is not a proper CWD")
Files.create(dirpath1, ".cwd", "A"*40)
assert decide_cwd(dirpath1, exists=True) == dirpath1
# Cleanup.
if orig_cuckoo:
os.environ["CUCKOO"] = orig_cuckoo
else:
os.environ.pop("CUCKOO", None)
if orig_cuckoo_cwd:
os.environ["CUCKOO_CWD"] = orig_cuckoo_cwd
else:
os.environ.pop("CUCKOO_CWD", None)
@pytest.mark.skipif("sys.platform != 'linux2'")
@mock.patch("cuckoo.misc.pwd")
@mock.patch("cuckoo.misc.os")
def test_drop_privileges(p, q):
drop_privileges("username")
q.getpwnam.assert_called_once_with("username")
p.setgroups.assert_called_once()
p.setgid.assert_called_once()
p.setuid.assert_called_once()
p.putenv.assert_called_once()
def test_structure():
class S1(Structure):
_pack_ = 1
_fields_ = [
("a", ctypes.c_ubyte),
("b", ctypes.c_ushort),
("c", ctypes.c_uint),
("d", ctypes.c_ubyte * 128),
]
class S2(Structure):
_pack_ = 1
_fields_ = [
("a", S1),
("b", ctypes.c_ulonglong),
("c", ctypes.c_char * 32),
]
a = S2.from_buffer_copy("A"*175)
assert a.a.a == 0x41
assert a.a.b == 0x4141
assert a.a.c == 0x41414141
assert a.a.d[:] == [0x41] * 128
assert a.b == 0x4141414141414141
assert a.c == "A"*32
assert a.as_dict() == {
"a": {
"a": 0x41,
"b": 0x4141,
"c": 0x41414141,
"d": [0x41] * 128,
},
"b": 0x4141414141414141,
"c": "A"*32,
}
def test_create_pidfile():
set_cwd(tempfile.mkdtemp())
cuckoo_create()
Pidfile("test1").create()
assert int(open(cwd("pidfiles", "test1.pid"), "rb").read()) == os.getpid()
def test_remove_pidfile():
set_cwd(tempfile.mkdtemp())
cuckoo_create()
Pidfile("test2").create()
assert os.path.exists(cwd("pidfiles", "test2.pid"))
Pidfile("test2").remove()
assert not os.path.exists(cwd("pidfiles", "test2.pid"))
def test_pidfile_exists_false():
set_cwd(tempfile.mkdtemp())
cuckoo_create()
assert not Pidfile("test3").exists()
def test_pidfile_exists_true():
set_cwd(tempfile.mkdtemp())
cuckoo_create()
p = Pidfile("test4")
p.create()
assert p.exists() and p.pid == os.getpid()
def test_pidfile_none():
set_cwd(tempfile.mkdtemp())
cuckoo_create()
p = Pidfile("test5")
p.create()
open(cwd("pidfiles", "test5.pid"), "wb").write("notapid")
assert p.read() is None
def test_proc_exists():
assert Pidfile("hello").proc_exists(os.getpid())
# Chances are possible, but slim.
assert not Pidfile("hello").proc_exists(13337)
assert not Pidfile("hello)").proc_exists(None)
assert not Pidfile("hello)").proc_exists("")
@mock.patch("cuckoo.misc.sys")
def test_pid_exists_unsupported_platform(p):
p.platform = "DogeOS"
assert Pidfile("hello").proc_exists(os.getpid()) is None
def test_active_pids():
set_cwd(tempfile.mkdtemp())
cuckoo_create()
Pidfile("test6").create()
assert Pidfile.get_active_pids() == {
"test6": os.getpid(),
}
def test_make_list():
assert make_list("hello") == ["hello"]
assert make_list(1) == [1]
assert make_list((1, 2)) == [1, 2]
assert make_list([3, 4]) == [3, 4]
def test_format_command():
set_cwd(tempfile.mkdtemp(), ".")
assert format_command("community") == "cuckoo community"
set_cwd(tempfile.mkdtemp(), "~/.cuckoo")
assert format_command("community") == "cuckoo community"
dirpath = tempfile.mkdtemp()
set_cwd(dirpath, dirpath)
assert format_command("community") == "cuckoo --cwd %s community" % cwd()
dirpath = tempfile.mkdtemp("foo bar")
set_cwd(dirpath, dirpath)
assert format_command("community") == 'cuckoo --cwd "%s" community' % cwd()
dirpath = tempfile.mkdtemp("foo ' bar")
set_cwd(dirpath, dirpath)
assert format_command("community") == 'cuckoo --cwd "%s" community' % cwd()