mirror of
https://github.com/rapid7/metasploit-payloads
synced 2025-04-24 10:09:49 +02:00
4ffe127f04
The 'common' library has been removed. The only project that actually used it was metsrv, so the code that metsrv required from common is now directly compiled in as part of that project. The common folder now contains files that are importanta cross all of the projects, with a primary focus on the new "API" style function. What this means is that MetSrv has an API that it exposes through a function pointer that is passed to the extension when it's initialised. This pointer references a structure with all the API functions wired in. This means that: * Extensions don't need to know anything about metsrv at compile time. * The delay loading code can be removed, which was one of the last instances of "metsrv.dll" as a string. * Metsrv.dll no longer exports any functions. More to come.
147 lines
4.3 KiB
C
147 lines
4.3 KiB
C
#ifndef _METERPRETER_COMMON_CHANNEL_H
|
|
#define _METERPRETER_COMMON_CHANNEL_H
|
|
|
|
#include "common_remote.h"
|
|
|
|
struct _Channel;
|
|
struct _ChannelBuffer;
|
|
|
|
// Direct I/O operation modes (read/write/close)
|
|
typedef enum
|
|
{
|
|
CHANNEL_DIO_MODE_OPEN = 0,
|
|
CHANNEL_DIO_MODE_READ = 1,
|
|
CHANNEL_DIO_MODE_WRITE = 2,
|
|
CHANNEL_DIO_MODE_CLOSE = 3,
|
|
CHANNEL_DIO_MODE_INTERACT = 3,
|
|
} ChannelDioMode;
|
|
|
|
// Direct I/O handler -- used in place of internal buffering for channels
|
|
// that can do event based forwarding of buffers.
|
|
typedef DWORD (*DirectIoHandler)(struct _Channel *channel,
|
|
struct _ChannelBuffer *buffer, LPVOID context, ChannelDioMode mode,
|
|
PUCHAR chunk, ULONG length, PULONG bytesXfered);
|
|
|
|
// Asynchronous completion routines -- used with channel_open, channel_read,
|
|
// etc.
|
|
typedef DWORD (*ChannelOpenCompletionRoutine)(Remote *remote,
|
|
struct _Channel *channel, LPVOID context, DWORD result);
|
|
typedef DWORD (*ChannelReadCompletionRoutine)(Remote *remote,
|
|
struct _Channel *channel, LPVOID context, DWORD result, PUCHAR buffer,
|
|
ULONG bytesRead);
|
|
typedef DWORD (*ChannelWriteCompletionRoutine)(Remote *remote,
|
|
struct _Channel *channel, LPVOID context, DWORD result,
|
|
ULONG bytesWritten);
|
|
typedef DWORD (*ChannelCloseCompletionRoutine)(Remote *remote,
|
|
struct _Channel *channel, LPVOID context, DWORD result);
|
|
typedef DWORD (*ChannelInteractCompletionRoutine)(Remote *remote,
|
|
struct _Channel *channel, LPVOID context, DWORD result);
|
|
|
|
// Completion routine wrapper context
|
|
typedef struct _ChannelCompletionRoutine
|
|
{
|
|
LPVOID context;
|
|
|
|
struct
|
|
{
|
|
ChannelOpenCompletionRoutine open;
|
|
ChannelReadCompletionRoutine read;
|
|
ChannelWriteCompletionRoutine write;
|
|
ChannelCloseCompletionRoutine close;
|
|
ChannelInteractCompletionRoutine interact;
|
|
} routine;
|
|
|
|
} ChannelCompletionRoutine;
|
|
|
|
// Logical channel buffer used to queue or for event based updating
|
|
typedef struct _ChannelBuffer
|
|
{
|
|
PUCHAR buffer;
|
|
ULONG currentSize;
|
|
ULONG totalSize;
|
|
|
|
// IO handler -- default is internal queuing
|
|
DirectIoHandler dio;
|
|
LPVOID dioContext;
|
|
} ChannelBuffer;
|
|
|
|
// Channel operations that are used by any channel
|
|
typedef struct _NativeChannelOps
|
|
{
|
|
LPVOID context;
|
|
DWORD (*write)(struct _Channel *channel, Packet *request,
|
|
LPVOID context, LPVOID buffer, DWORD bufferSize,
|
|
LPDWORD bytesWritten);
|
|
DWORD (*close)(struct _Channel *channel, Packet *request,
|
|
LPVOID context);
|
|
DWORD (*interact)(struct _Channel *channel, Packet *request,
|
|
LPVOID context, BOOLEAN interact);
|
|
} NativeChannelOps;
|
|
|
|
// Channel operations for a stream-based channel
|
|
typedef struct _StreamChannelOps
|
|
{
|
|
NativeChannelOps native;
|
|
} StreamChannelOps;
|
|
|
|
// Channel operations for a datagram-based channel
|
|
typedef struct _DatagramChannelOps
|
|
{
|
|
NativeChannelOps native;
|
|
} DatagramChannelOps;
|
|
|
|
// Channel operations for a pool-based channel
|
|
typedef struct _PoolChannelOps
|
|
{
|
|
NativeChannelOps native;
|
|
DWORD (*read)(struct _Channel *channel, Packet *request,
|
|
LPVOID context, LPVOID buffer, DWORD bufferSize,
|
|
LPDWORD bytesRead);
|
|
DWORD (*eof)(struct _Channel *channel, Packet *request,
|
|
LPVOID context, LPBOOL isEof);
|
|
DWORD (*seek)(struct _Channel *channel, Packet *request,
|
|
LPVOID context, LONG offset, DWORD whence);
|
|
DWORD (*tell)(struct _Channel *channel, Packet *request,
|
|
LPVOID context, LPLONG offset);
|
|
} PoolChannelOps;
|
|
|
|
/*
|
|
* Values for the 'cls' attribute
|
|
*/
|
|
#define CHANNEL_CLASS_BUFFERED 0
|
|
#define CHANNEL_CLASS_STREAM 1
|
|
#define CHANNEL_CLASS_DATAGRAM 2
|
|
#define CHANNEL_CLASS_POOL 3
|
|
|
|
typedef struct _Channel
|
|
{
|
|
// The channel's identifier
|
|
DWORD identifier;
|
|
// The channel's class
|
|
DWORD cls;
|
|
// The type of channel, NULL for default.
|
|
PCHAR type;
|
|
// Flag for whether or not the channel is currently interactive
|
|
BOOL interactive;
|
|
// Operational flags
|
|
ULONG flags;
|
|
// Lock for synchronizing communication to a channel
|
|
LOCK * lock;
|
|
// The buffered output buffer (as in being outputted bufferedly)
|
|
union
|
|
{
|
|
ChannelBuffer buffered;
|
|
StreamChannelOps stream;
|
|
DatagramChannelOps datagram;
|
|
PoolChannelOps pool;
|
|
} ops;
|
|
|
|
// Internal attributes for list
|
|
struct _Channel *prev;
|
|
struct _Channel *next;
|
|
} Channel;
|
|
|
|
#define CHANNEL_CHUNK_SIZE 4096
|
|
|
|
#endif
|