/*
* ProFTPD - FTP server daemon
* Copyright (c) 1997, 1998 Public Flood Software
* Copyright (c) 1999, 2000 MacGyver aka Habeeb J. Dihu <macgyver@tos.net>
* Copyright (c) 2001, 2002, 2003 The ProFTPD Project team
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
*
* As a special exemption, Public Flood Software/MacGyver aka Habeeb J. Dihu
* and other respective copyright holders give permission to link this program
* with OpenSSL, and distribute the resulting executable, without including
* the source code for OpenSSL in the source distribution.
*/
/* ProFTPD module definitions.
*
* $Id: modules.h,v 1.45 2004/11/10 18:19:57 castaglia Exp $
*/
#ifndef PR_MODULES_H
#define PR_MODULES_H
typedef struct module_struc module;
typedef struct modret_struc modret_t;
struct modret_struc {
module *mr_handler_module; /* which module handled this? */
int mr_error; /* !0 if error */
char *mr_numeric; /* numeric error code */
char *mr_message; /* text message */
void *data; /* add'l data -- undefined */
};
/* The following macros are for creating basic modret_t, and can
* only be used inside of module handlers
*/
#define MODRET static modret_t*
#define HANDLED(cmd) mod_create_ret((cmd),\
0,NULL,NULL)
#define DECLINED(cmd) (modret_t*)NULL
#define ERROR(cmd) mod_create_ret((cmd),\
1,NULL,NULL)
#define ERROR_MSG(cmd,n,m) mod_create_ret((cmd),\
1,(n),(m))
#define ERROR_INT(cmd,n) mod_create_error((cmd),(n))
#define MODRET_ISDECLINED(x) ((x) == NULL)
#define MODRET_ISHANDLED(x) ((x) && !(x)->mr_error)
#define MODRET_ISERROR(x) ((x) && (x)->mr_error)
#define MODRET_HASNUM(x) ((x) && (x)->mr_numeric)
#define MODRET_HASMSG(x) ((x) && (x)->mr_message)
#define MODRET_ERROR(x) ((x) ? (x)->mr_error : 0)
#define MODRET_ERRNUM(x) ((x) ? (x)->mr_numeric : NULL)
#define MODRET_ERRMSG(x) ((x) ? (x)->mr_message : NULL)
#define MODRET_HASDATA(x) ((x) ? ((x)->data ? TRUE : FALSE) : FALSE)
/* private data structure returned by mod_priv* */
struct privdata {
char *tag;
union {
void *ptr_val;
int int_val;
long long_val;
char *str_val;
} value;
module *m;
};
typedef struct {
char *directive;
modret_t *(*handler)(cmd_rec*);
module *m; /* Reference to owning module
* set when module is initialized
*/
} conftable;
/* classes for command table */
#define CL_NONE 0x0
#define CL_AUTH (1 << 0) /* USER, PASS */
#define CL_INFO (1 << 1) /* Informational commands (PWD, SYST, etc) */
#define CL_DIRS (1 << 2) /* Directory commands (LIST, NLST, CWD, etc) */
#define CL_READ (1 << 3) /* File reading commands (RETR) */
#define CL_WRITE (1 << 4) /* Writing commands (STOR, MKD, etc) */
#define CL_MISC (1 << 5) /* Miscellaneous (RNFR/RNTO, SITE, etc) */
#define CL_SEC (1 << 6) /* RFC2228 Security commands */
#define CL_ALL (CL_AUTH|CL_INFO|CL_DIRS|CL_READ| \
CL_WRITE|CL_MISC|CL_SEC)
/* Command handler types for command table */
#define PRE_CMD 1
#define CMD 2
#define POST_CMD 3
#define POST_CMD_ERR 4
#define LOG_CMD 5
#define LOG_CMD_ERR 6
#define HOOK 7
typedef struct {
/* See above for cmd types. */
unsigned char cmd_type;
char *command;
/* Command group. */
char *group;
modret_t *(*handler)(cmd_rec*);
/* Does this command require authentication? */
unsigned char requires_auth;
/* Can this command be issued during a transfer? (Now obsolete) */
unsigned char interrupt_xfer;
int class;
module *m;
} cmdtable;
typedef struct {
int auth_flags; /* future use */
char *name;
modret_t *(*handler)(cmd_rec*);
module *m;
} authtable;
#define PR_AUTH_FL_REQUIRED 0x00001
struct module_struc {
module *next,*prev;
int api_version; /* API version _not_ module version */
char *name; /* Module name */
conftable *conftable; /* Configuration directive table */
cmdtable *cmdtable; /* Command table */
authtable *authtable; /* Authentication handler table */
int (*init)(void); /* Module initialization */
int (*sess_init)(void); /* Session initialization */
char *module_version; /* Module version */
void *handle; /* Module handle */
/* Internal use; high number == higher priority. */
int priority;
};
#define ANY_MODULE ((module*)0xffffffff)
/* Prototypes */
unsigned char command_exists(char *);
int modules_init(void);
void modules_list(void);
int modules_session_init(void);
unsigned char pr_module_exists(const char *);
module *pr_module_get(const char *);
int pr_module_load(module *m);
int pr_module_unload(module *m);
modret_t *call_module(module *, modret_t *(*)(cmd_rec *), cmd_rec *);
/* Symbol table hash ("stash") support. */
typedef enum {
PR_SYM_CONF = 1,
PR_SYM_CMD,
PR_SYM_AUTH,
PR_SYM_HOOK
} pr_stash_type_t;
int init_stash(void);
int pr_stash_add_symbol(pr_stash_type_t, void *);
void *pr_stash_get_symbol(pr_stash_type_t, const char *, void *, int *);
int pr_stash_remove_symbol(pr_stash_type_t, const char *, module *);
/* This function is in main.c, but is prototyped here */
void set_auth_check(int (*ck)(cmd_rec *));
/* This callback is defined/stored in src/main.c */
extern int (*cmd_auth_chk)(cmd_rec *);
/* For use from inside module handler functions */
modret_t *mod_create_ret(cmd_rec *, unsigned char, char *, char *);
modret_t *mod_create_error(cmd_rec *, int);
modret_t *mod_create_data(cmd_rec *, void *);
/* Implemented in main.c */
void pr_cmd_dispatch(cmd_rec *);
/* Implemented in mod_core.c */
int core_chgrp(cmd_rec *, char *, uid_t, gid_t);
int core_chmod(cmd_rec *, char *, mode_t);
#endif /* PR_MODULES_H */
Last Updated: Thu Feb 23 11:06:46 2006
HTML generated by tj's src2html script