Blame src/nlmsg.c

Packit c43939
/*
Packit c43939
 * (C) 2012 by Pablo Neira Ayuso <pablo@netfilter.org>
Packit c43939
 *
Packit c43939
 * This program is free software; you can redistribute it and/or modify
Packit c43939
 * it under the terms of the GNU General Public License as published
Packit c43939
 * by the Free Software Foundation; either version 2 of the License, or
Packit c43939
 * (at your option) any later version.
Packit c43939
 */
Packit c43939
#include <arpa/inet.h>
Packit c43939
#include <time.h>
Packit c43939
#include <endian.h>
Packit c43939
#include <stdlib.h>
Packit c43939
#include <string.h>
Packit c43939
Packit c43939
#include <libmnl/libmnl.h>
Packit c43939
Packit c43939
#ifndef __aligned_be64
Packit c43939
#define __aligned_be64 __be64 __attribute__((aligned(8)))
Packit c43939
#define __aligned_le64 __le64 __attribute__((aligned(8)))
Packit c43939
#endif
Packit c43939
Packit c43939
#include <linux/netfilter/nfnetlink_queue.h>
Packit c43939
Packit c43939
#include <libnetfilter_queue/libnetfilter_queue.h>
Packit c43939
Packit c43939
#include "internal.h"
Packit c43939
Packit c43939
/**
Packit c43939
 * \defgroup nfq_verd Verdict helpers
Packit c43939
 * @{
Packit c43939
 */
Packit c43939
Packit c43939
/**
Packit c43939
 * nfq_nlmsg_verdict_put - Put a verdict into a Netlink message
Packit c43939
 * \param nlh Pointer to netlink message
Packit c43939
 * \param id ID assigned to packet by netfilter
Packit c43939
 * \param verdict verdict to return to netfilter (see \b Verdicts below)
Packit c43939
 * \par Verdicts
Packit c43939
 * __NF_DROP__ Drop the packet. This is final.
Packit c43939
 * \n
Packit c43939
 * __NF_ACCEPT__ Accept the packet. Processing of the current base chain
Packit c43939
 * and any called chains terminates,
Packit c43939
 * but the packet may still be processed by subsequently invoked base chains.
Packit c43939
 * \n
Packit c43939
 * __NF_STOP__ Like __NF_ACCEPT__, but skip any further base chains using the
Packit c43939
 * current hook.
Packit c43939
 * \n
Packit c43939
 * __NF_REPEAT__ Like __NF_ACCEPT__, but re-queue this packet to the
Packit c43939
 * current base chain. One way to prevent a re-queueing loop is to
Packit c43939
 * also set a packet mark using nfq_nlmsg_verdict_put_mark() and have the
Packit c43939
 * program test for this mark in \c attr[NFQA_MARK]; or have the nefilter rules
Packit c43939
 * do this test.
Packit c43939
 * \n
Packit c43939
 * __NF_QUEUE_NR__(*new_queue*) Like __NF_ACCEPT__, but queue this packet to
Packit c43939
 * queue number *new_queue*. As with the command-line \b queue \b num verdict,
Packit c43939
 * if no process is listening to that queue then the packet is discarded; but
Packit c43939
 * again like with the command-line, one may OR in a flag to bypass *new_queue*
Packit c43939
 *  if there is no listener, as in this snippet:
Packit c43939
 * \verbatim
Packit c43939
       nfq_nlmsg_verdict_put(nlh, id, NF_QUEUE_NR(new_queue) |
Packit c43939
	       NF_VERDICT_FLAG_QUEUE_BYPASS);
Packit c43939
\endverbatim
Packit c43939
 *
Packit c43939
 * See examples/nf-queue.c, line
Packit c43939
 * 46
Packit c43939
 * for an example of how to use this function in context.
Packit c43939
 * The calling sequence is \b main --> \b mnl_cb_run --> \b queue_cb -->
Packit c43939
 * \b nfq_send_verdict --> \b nfq_nlmsg_verdict_put
Packit c43939
 * (\b cb being short for \b callback).
Packit c43939
 */
Packit c43939
EXPORT_SYMBOL
Packit c43939
void nfq_nlmsg_verdict_put(struct nlmsghdr *nlh, int id, int verdict)
Packit c43939
{
Packit c43939
	struct nfqnl_msg_verdict_hdr vh = {
Packit c43939
		.verdict	= htonl(verdict),
Packit c43939
		.id		= htonl(id),
Packit c43939
	};
Packit c43939
	mnl_attr_put(nlh, NFQA_VERDICT_HDR, sizeof(vh), &vh;;
Packit c43939
}
Packit c43939
Packit c43939
/**
Packit c43939
 * nfq_nlmsg_verdict_put_mark - Put a packet mark into a netlink message
Packit c43939
 * \param nlh Pointer to netlink message
Packit c43939
 * \param mark Value of mark to put
Packit c43939
 *
Packit c43939
 * The mark becomes part of the packet's metadata, and may be tested by the *nft
Packit c43939
 * primary expression* **meta mark**
Packit c43939
 * \sa __nft__(1)
Packit c43939
 */
Packit c43939
EXPORT_SYMBOL
Packit c43939
void nfq_nlmsg_verdict_put_mark(struct nlmsghdr *nlh, uint32_t mark)
Packit c43939
{
Packit c43939
	mnl_attr_put_u32(nlh, NFQA_MARK, htonl(mark));
Packit c43939
}
Packit c43939
Packit c43939
EXPORT_SYMBOL
Packit c43939
/**
Packit c43939
 * nfq_nlmsg_verdict_put_pkt - Put replacement packet content into a netlink
Packit c43939
 * message
Packit c43939
 * \param nlh Pointer to netlink message
Packit c43939
 * \param pkt Pointer to start of modified IP datagram
Packit c43939
 * \param plen Length of modified IP datagram
Packit c43939
 *
Packit c43939
 * There is only ever a need to return packet content if it has been modified.
Packit c43939
 * Usually one of the nfq_*_mangle_* functions does the modifying.
Packit c43939
 *
Packit c43939
 * This code snippet uses nfq_udp_mangle_ipv4. See nf-queue.c for
Packit c43939
 * context:
Packit c43939
 * \verbatim
Packit c43939
// main calls queue_cb (line 64) to process an enqueued packet:
Packit c43939
	// Extra variables
Packit c43939
	uint8_t *payload, *rep_data;
Packit c43939
	unsigned int match_offset, match_len, rep_len;
Packit c43939
Packit c43939
	// The next line was commented-out (with payload void*)
Packit c43939
	payload = mnl_attr_get_payload(attr[NFQA_PAYLOAD]);
Packit c43939
	// Copy data to a packet buffer (allow 255 bytes for mangling).
Packit c43939
	pktb = pktb_alloc(AF_INET, payload, plen, 255);
Packit c43939
	// (decide that this packet needs mangling)
Packit c43939
	nfq_udp_mangle_ipv4(pktb, match_offset, match_len, rep_data, rep_len);
Packit c43939
	// nfq_udp_mangle_ipv4 updates packet length, no need to track locally
Packit c43939
Packit c43939
	// Eventually nfq_send_verdict (line 39) gets called
Packit c43939
	// The received packet may or may not have been modified.
Packit c43939
	// Add this code before nfq_nlmsg_verdict_put call:
Packit c43939
	if (pktb_mangled(pktb))
Packit c43939
		nfq_nlmsg_verdict_put_pkt(nlh, pktb_data(pktb), pktb_len(pktb));
Packit c43939
\endverbatim
Packit c43939
 */
Packit c43939
void nfq_nlmsg_verdict_put_pkt(struct nlmsghdr *nlh, const void *pkt,
Packit c43939
			       uint32_t plen)
Packit c43939
{
Packit c43939
	mnl_attr_put(nlh, NFQA_PAYLOAD, plen, pkt);
Packit c43939
}
Packit c43939
Packit c43939
/**
Packit c43939
 * @}
Packit c43939
 */
Packit c43939
Packit c43939
/**
Packit c43939
 * \defgroup nfq_cfg Config helpers
Packit c43939
 * @{
Packit c43939
 */
Packit c43939
Packit c43939
/**
Packit c43939
 * nfq_nlmsg_cfg_put_cmd Add netlink config command to netlink message
Packit c43939
 * \param nlh Pointer to netlink message
Packit c43939
 * \param pf Packet family (e.g. AF_INET)
Packit c43939
 * \param cmd nfqueue nfnetlink command.
Packit c43939
 *
Packit c43939
 * Possible commands are:
Packit c43939
 *
Packit c43939
 * - NFQNL_CFG_CMD_NONE: Do nothing. It can be useful to know if the queue
Packit c43939
 *   subsystem is working.
Packit c43939
 * - NFQNL_CFG_CMD_BIND: Binds the program to a specific queue.
Packit c43939
 * - NFQNL_CFG_CMD_UNBIND: Unbinds the program to a specifiq queue.
Packit c43939
 *
Packit c43939
 * Obsolete commands:
Packit c43939
 * - NFQNL_CFG_CMD_PF_BIND: Binds to process packets belonging to the given
Packit c43939
 *   protocol family (ie. PF_INET, PF_INET6, etc).
Packit c43939
 * - NFQNL_CFG_CMD_PF_UNBIND: Unbinds from processing packets belonging to the
Packit c43939
 *   given protocol family.  Both commands are ignored by Linux kernel 3.8 and
Packit c43939
 *   later versions.
Packit c43939
 */
Packit c43939
EXPORT_SYMBOL
Packit c43939
void nfq_nlmsg_cfg_put_cmd(struct nlmsghdr *nlh, uint16_t pf, uint8_t cmd)
Packit c43939
{
Packit c43939
	struct nfqnl_msg_config_cmd command = {
Packit c43939
		.command = cmd,
Packit c43939
		.pf = htons(pf),
Packit c43939
	};
Packit c43939
	mnl_attr_put(nlh, NFQA_CFG_CMD, sizeof(command), &command);
Packit c43939
}
Packit c43939
Packit c43939
/**
Packit c43939
 * nfq_nlmsg_cfg_put_params Add parameter to netlink message
Packit c43939
 * \param nlh Pointer to netlink message
Packit c43939
 * \param mode one of NFQNL_COPY_NONE, NFQNL_COPY_META or NFQNL_COPY_PACKET
Packit c43939
 * \param range value of parameter
Packit c43939
 */
Packit c43939
EXPORT_SYMBOL
Packit c43939
void nfq_nlmsg_cfg_put_params(struct nlmsghdr *nlh, uint8_t mode, int range)
Packit c43939
{
Packit c43939
	struct nfqnl_msg_config_params params = {
Packit c43939
		.copy_range = htonl(range),
Packit c43939
		.copy_mode = mode,
Packit c43939
	};
Packit c43939
	mnl_attr_put(nlh, NFQA_CFG_PARAMS, sizeof(params), &params);
Packit c43939
}
Packit c43939
Packit c43939
/**
Packit c43939
 * nfq_nlmsg_cfg_put_qmaxlen Add queue maximum length to netlink message
Packit c43939
 * \param nlh Pointer to netlink message
Packit c43939
 * \param queue_maxlen Maximum queue length
Packit c43939
 */
Packit c43939
EXPORT_SYMBOL
Packit c43939
void nfq_nlmsg_cfg_put_qmaxlen(struct nlmsghdr *nlh, uint32_t queue_maxlen)
Packit c43939
{
Packit c43939
	mnl_attr_put_u32(nlh, NFQA_CFG_QUEUE_MAXLEN, htonl(queue_maxlen));
Packit c43939
}
Packit c43939
Packit c43939
/**
Packit c43939
 * @}
Packit c43939
 */
Packit c43939
Packit c43939
/**
Packit c43939
 * \defgroup nlmsg Netlink message helper functions
Packit c43939
 * @{
Packit c43939
 */
Packit c43939
Packit c43939
static int nfq_pkt_parse_attr_cb(const struct nlattr *attr, void *data)
Packit c43939
{
Packit c43939
	const struct nlattr **tb = data;
Packit c43939
	int type = mnl_attr_get_type(attr);
Packit c43939
Packit c43939
	/* skip unsupported attribute in user-space */
Packit c43939
	if (mnl_attr_type_valid(attr, NFQA_MAX) < 0)
Packit c43939
		return MNL_CB_OK;
Packit c43939
Packit c43939
	switch(type) {
Packit c43939
	case NFQA_MARK:
Packit c43939
	case NFQA_IFINDEX_INDEV:
Packit c43939
	case NFQA_IFINDEX_OUTDEV:
Packit c43939
	case NFQA_IFINDEX_PHYSINDEV:
Packit c43939
	case NFQA_IFINDEX_PHYSOUTDEV:
Packit c43939
	case NFQA_CAP_LEN:
Packit c43939
	case NFQA_SKB_INFO:
Packit c43939
	case NFQA_SECCTX:
Packit c43939
	case NFQA_UID:
Packit c43939
	case NFQA_GID:
Packit c43939
	case NFQA_CT_INFO:
Packit c43939
		if (mnl_attr_validate(attr, MNL_TYPE_U32) < 0)
Packit c43939
			return MNL_CB_ERROR;
Packit c43939
		break;
Packit c43939
	case NFQA_TIMESTAMP:
Packit c43939
		if (mnl_attr_validate2(attr, MNL_TYPE_UNSPEC,
Packit c43939
		    sizeof(struct nfqnl_msg_packet_timestamp)) < 0) {
Packit c43939
			return MNL_CB_ERROR;
Packit c43939
		}
Packit c43939
		break;
Packit c43939
	case NFQA_HWADDR:
Packit c43939
		if (mnl_attr_validate2(attr, MNL_TYPE_UNSPEC,
Packit c43939
		    sizeof(struct nfqnl_msg_packet_hw)) < 0) {
Packit c43939
			return MNL_CB_ERROR;
Packit c43939
		}
Packit c43939
		break;
Packit c43939
	case NFQA_PACKET_HDR:
Packit c43939
		if (mnl_attr_validate2(attr, MNL_TYPE_UNSPEC,
Packit c43939
		    sizeof(struct nfqnl_msg_packet_hdr)) < 0) {
Packit c43939
			return MNL_CB_ERROR;
Packit c43939
		}
Packit c43939
		break;
Packit c43939
	case NFQA_PAYLOAD:
Packit c43939
	case NFQA_CT:
Packit c43939
	case NFQA_EXP:
Packit c43939
		break;
Packit c43939
	}
Packit c43939
	tb[type] = attr;
Packit c43939
	return MNL_CB_OK;
Packit c43939
}
Packit c43939
Packit c43939
/**
Packit c43939
 * nfq_nlmsg_parse - set packet attributes from netlink message
Packit c43939
 * \param nlh Pointer to netlink message
Packit c43939
 * \param attr Pointer to array of attributes to set
Packit c43939
 * \returns MNL_CB_OK on success or MNL_CB_ERROR if any error occurs
Packit c43939
 */
Packit c43939
EXPORT_SYMBOL
Packit c43939
int nfq_nlmsg_parse(const struct nlmsghdr *nlh, struct nlattr **attr)
Packit c43939
{
Packit c43939
	return mnl_attr_parse(nlh, sizeof(struct nfgenmsg),
Packit c43939
			      nfq_pkt_parse_attr_cb, attr);
Packit c43939
}
Packit c43939
Packit c43939
/**
Packit c43939
 * nfq_nlmsg_put - Convert memory buffer into a Netlink buffer
Packit c43939
 * \param *buf Pointer to memory buffer
Packit c43939
 * \param type Either NFQNL_MSG_CONFIG or NFQNL_MSG_VERDICT
Packit c43939
 * \param queue_num Queue number
Packit c43939
 * \returns Pointer to netlink message
Packit c43939
 */
Packit c43939
EXPORT_SYMBOL
Packit c43939
struct nlmsghdr *nfq_nlmsg_put(char *buf, int type, uint32_t queue_num)
Packit c43939
{
Packit c43939
	struct nlmsghdr *nlh = mnl_nlmsg_put_header(buf);
Packit c43939
	nlh->nlmsg_type = (NFNL_SUBSYS_QUEUE << 8) | type;
Packit c43939
	nlh->nlmsg_flags = NLM_F_REQUEST;
Packit c43939
Packit c43939
	struct nfgenmsg *nfg = mnl_nlmsg_put_extra_header(nlh, sizeof(*nfg));
Packit c43939
	nfg->nfgen_family = AF_UNSPEC;
Packit c43939
	nfg->version = NFNETLINK_V0;
Packit c43939
	nfg->res_id = htons(queue_num);
Packit c43939
Packit c43939
	return nlh;
Packit c43939
}
Packit c43939
Packit c43939
/**
Packit c43939
 * @}
Packit c43939
 */