REDROOM

Navigation

Breadcrumbs

/ / usr / include / proftpd

Create

Create File | Create Folder | Upload Files | Run Command

Preview: log.h Size: 6.66 KB

//usr/include/proftpd/log.h

/*
 * 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-2020 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., 51 Franklin Street, Suite 500, Boston, MA 02110-1335, 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.
 */

/* Logging, either to syslog or stderr, as well as debug logging
 * and debug levels.
 */

#ifndef PR_LOG_H
#define PR_LOG_H

#ifndef LOG_AUTHPRIV
#define LOG_AUTHPRIV LOG_AUTH
#endif

#if !defined(WTMP_FILE) && defined(_PATH_WTMP)
#define WTMP_FILE _PATH_WTMP
#endif

/* These are the debug levels, higher numbers print more debugging
 * info.  DEBUG0 (the default) prints nothing.
 */

#define DEBUG10		10
#define DEBUG9		9
#define DEBUG8		8
#define DEBUG7		7
#define DEBUG6		6
#define DEBUG5		5
#define DEBUG4		4
#define	DEBUG3		3
#define DEBUG2		2
#define DEBUG1		1
#define DEBUG0		0

/* pr_log_openfile() return values */
#define PR_LOG_WRITABLE_DIR	-2
#define PR_LOG_SYMLINK		-3

/* Log file modes */
#define PR_LOG_SYSTEM_MODE	0640

#ifdef PR_USE_LASTLOG

/* It is tempting to want to have these lastlog-related includes separated
 * out into their own lastlog.h file.  However, on some systems, such a
 * proftpd-specific lastlog.h file may collide with the system's lastlog.h
 * file.  Ultimately it's an issue with the default search order of the
 * system C preprocessor, not with us -- and not every installation has
 * this problem.
 *
 * In the meantime, the most portable thing is to keep these lastlog-related
 * includes in this file.  Yay portability.
 */

#ifdef HAVE_LASTLOG_H
# include <lastlog.h>
#endif

#ifdef HAVE_LOGIN_H
# include <login.h>
#endif

#ifdef HAVE_PATHS_H
# include <paths.h>
#endif

#ifndef PR_LASTLOG_PATH
# ifdef _PATH_LASTLOG
#   define PR_LASTLOG_PATH      _PATH_LASTLOG
# else
#   ifdef LASTLOG_FILE
#     define PR_LASTLOG_PATH    LASTLOG_FILE
#   else
#     error "Missing path to lastlog file (use --with-lastlog=PATH)"
#   endif
# endif
#endif

int log_lastlog(uid_t uid, const char *user_name, const char *tty,
  const pr_netaddr_t *remote_addr);
#endif /* PR_USE_LASTLOG */

/* Note: Like lastlog.h, it would be tempting to split out the declaration of
 * this function, and its necessary system headers, into a proftpd-specific
 * wtmp.h file.  But that would collide with the system wtmp.h file on
 * some systems.
 */
int log_wtmp(const char *, const char *, const char *, const pr_netaddr_t *);

/* file-based logging functions */
int pr_log_openfile(const char *, int *, mode_t);

int pr_log_writefile(int, const char *, const char *, ...)
#ifdef __GNUC__
  __attribute__ ((format (printf, 3, 4)));
#else
  ;
#endif

/* Same as pr_log_writefile(), only this function takes a va_list.
 * Useful for modules which provide their own varargs wrapper log functions,
 * but still want to use the core facilities for writing to the log fd.
 */
int pr_log_vwritefile(int, const char *, const char *, va_list ap);

/* syslog-based logging functions.  Note that the open/close functions are
 * not part of the public API; use the pr_log_pri() function to log via
 * syslog.
 */
void log_closesyslog(void);
int log_opensyslog(const char *);
int log_getfacility(void);
void log_setfacility(int);

void pr_log_pri(int, const char *, ...)
#ifdef __GNUC__
       __attribute__ ((format (printf, 2, 3)));
#else
       ;
#endif

void pr_log_auth(int, const char *, ...)
#ifdef __GNUC__
       __attribute__ ((format (printf, 2, 3)));
#else
       ;
#endif

void pr_log_debug(int, const char *, ...)
#ifdef __GNUC__
       __attribute__ ((format (printf, 2, 3)));
#else
       ;
#endif

int pr_log_setdebuglevel(int);
int pr_log_setdefaultlevel(int);

void log_stderr(int);
void log_discard(void);
void init_log(void);

int pr_log_str2sysloglevel(const char *);

/* Define a struct, and some constants, for logging events and any listeners
 * for those events.
 */
typedef struct log_event {

  /* Type of log event/message; the values are defined below */
  unsigned int log_type;

  /* Log fd associated with this log for this event */
  int log_fd;

  /* Log level of this message; the semantics of the log level depend on
   * on the log type.
   */
  int log_level;

  /* The message being logged. */
  const char *log_msg;
  size_t log_msglen;

} pr_log_event_t;

#define PR_LOG_TYPE_UNSPEC	0
#define PR_LOG_NAME_UNSPEC	"core.log.unspec"

#define PR_LOG_TYPE_XFERLOG	1
#define PR_LOG_NAME_XFERLOG	"core.log.xferlog"

#define PR_LOG_TYPE_SYSLOG	2
#define PR_LOG_NAME_SYSLOG	"core.log.syslog"

#define PR_LOG_TYPE_SYSTEMLOG	3
#define PR_LOG_NAME_SYSTEMLOG	"core.log.systemlog"

#define PR_LOG_TYPE_EXTLOG	4
#define PR_LOG_NAME_EXTLOG	"core.log.extendedlog"

#define PR_LOG_TYPE_TRACELOG	5
#define PR_LOG_NAME_TRACELOG	"core.log.tracelog"

/* Helper function to generate the necessary log event, passing along the
 * log event context data.
 */
int pr_log_event_generate(unsigned int log_type, int log_fd, int log_level,
  const char *log_msg, size_t log_msglen);

/* Returns TRUE if there are listeners for the specified log type, FALSE
 * otherwise.
 */
int pr_log_event_listening(unsigned int log_type);

/* Log a stacktrace, starting at the location of the calling function.
 * Note that if fd is less than zero, OR if the given name is null, then the
 * stacktrace will be logged using pr_log_pri(), otherwise the stacktrace will
 * be written to the provided file descriptor.
 */
void pr_log_stacktrace(int fd, const char *name);

/* Set options that affect the format of the logged messages. */
int pr_log_set_options(unsigned long log_opts);
#define PR_LOG_OPT_USE_TIMESTAMP			0x0001
#define PR_LOG_OPT_USE_HOSTNAME				0x0002
#define PR_LOG_OPT_USE_VHOST				0x0004
#define PR_LOG_OPT_USE_ROLE_BASED_PROCESS_LABELS	0x0008
#define PR_LOG_OPT_DEFAULT		(PR_LOG_OPT_USE_TIMESTAMP|PR_LOG_OPT_USE_HOSTNAME|PR_LOG_OPT_USE_VHOST)

#endif /* PR_LOG_H */

Directory Contents

Dirs: 0 × Files: 76

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
ascii.h	2.61 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
auth.h	6.23 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
base.h	3.42 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
bindings.h	7.84 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
buildstamp.h	50 B	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
ccan-json.h	3.59 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
child.h	1.48 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
class.h	3.02 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
cmd.h	4.36 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
compat.h	1.29 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
conf.h	3.86 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
config.h	35.77 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
configdb.h	5.73 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
ctrls.h	8.32 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
data.h	2.52 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
default_paths.h	2.97 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
dirtree.h	7.47 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
display.h	2.46 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
encode.h	3.67 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
env.h	1.87 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
error.h	18.45 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
event.h	3.50 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
expr.h	2.16 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
feat.h	1.27 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
filter.h	2.06 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
fsio.h	19.07 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
ftp.h	8.98 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
glibc-glob.h	7.12 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
hanson-tpl.h	4.40 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
help.h	1.24 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
ident.h	1.30 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
inet.h	5.27 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
jot.h	8.53 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
json.h	6.13 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
lastlog.h	1.62 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
log.h	6.66 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
logfmt.h	3.36 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
memcache.h	4.94 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
mkhome.h	1.53 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
modules.h	6.32 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
mod_ctrls.h	3.96 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
mod_sftp.h	10.70 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
mod_tls.h	6.33 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
netacl.h	2.51 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
netaddr.h	15.62 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
netio.h	7.98 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
openbsd-blowfish.h	2.90 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
options.h	8.33 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
os.h	7.22 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
parser.h	6.20 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
pidfile.h	1.30 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
pool.h	4.04 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
pr-syslog.h	3.47 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
privs.h	2.55 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
proctitle.h	1.64 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
proftpd.h	9.50 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
random.h	1.29 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
redis.h	15.58 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
regexp.h	3.63 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
response.h	3.07 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
rlimit.h	1.83 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
scoreboard.h	4.65 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
session.h	4.33 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
sets.h	1.94 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
signals.h	1.83 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
stash.h	2.12 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
str.h	5.59 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
support.h	4.39 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
table.h	11.60 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
throttle.h	1.27 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
timers.h	3.29 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
trace.h	2.36 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
utf8.h	1.37 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
var.h	4.32 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
version.h	1.59 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive
xferlog.h	1.34 KB	lrw-r--r--	2025-06-09 17:22:04	Edit Download recursive recursive