X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=error.h;h=507f9e24e7700b62701bb8b489b49a329e4fddf0;hp=430c12f9fa82be81dc8b876f43a40bc32a1cebc6;hb=55030e0d1a28ded2076d62fb9aac3539ff337275;hpb=d46fe38dcada4108ed49a0e621376df0f7913fe3 diff --git a/error.h b/error.h index 430c12f9..507f9e24 100644 --- a/error.h +++ b/error.h @@ -1,26 +1,14 @@ /* - * Copyright (C) 2006 Andre Noll + * Copyright (C) 2006-2007 Andre Noll * - * 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, USA. + * Licensed under the GPL v2. For licencing details see COPYING. */ /** \file error.h list of error messages for all subsystems */ /** \cond list of all subsystems that support the shiny error facility */ enum para_subsystem { - SS_SCHED, + SS_CLIENT, SS_GUI, SS_TIME, SS_WAV, @@ -32,7 +20,11 @@ enum para_subsystem { SS_RECV, SS_NET, SS_ORTP_RECV, + SS_CLIENT_COMMON, + SS_AUDIOC, + SS_SCHED, SS_AUDIOD, + SS_AUDIOD_COMMAND, SS_EXEC, SS_STDIN, SS_STDOUT, @@ -51,7 +43,7 @@ enum para_subsystem { SS_CRYPT, SS_HTTP_SEND, SS_ORTP_SEND, - SS_DB, + SS_AFS_COMMON, SS_OGG_AFH, SS_MP3_AFH, SS_AAC_AFH, @@ -59,7 +51,7 @@ enum para_subsystem { SS_AACDEC, SS_AAC_COMMON, SS_SERVER, - SS_AFS, + SS_VSS, SS_MYSQL_SELECTOR, SS_IPC, SS_DCCP, @@ -67,13 +59,28 @@ enum para_subsystem { SS_FD, SS_WRITE, SS_WRITE_COMMON, - SS_ALSA_WRITER, - SS_FILE_WRITER, + SS_ALSA_WRITE, + SS_FILE_WRITE, + SS_OSX_WRITE, + SS_USER_LIST, + SS_CHUNK_QUEUE, + SS_AFS, + SS_OSL, + SS_AFT, + SS_MOOD, + SS_SCORE, + SS_ATTRIBUTE, + SS_BLOB, + SS_PLAYLIST, + SS_SHA1, + SS_RBTREE, + SS_FSCK, NUM_SS }; /* these do not need error handling (yet) */ #define SERVER_ERRORS +#define CLIENT_ERRORS #define WAV_ERRORS #define COMPRESS_ERRORS #define TIME_ERRORS @@ -82,15 +89,150 @@ enum para_subsystem { #define ORTP_SEND_ERRORS #define GUI_ERRORS #define RINGBUFFER_ERRORS - - +#define SCORE_ERRORS +#define SHA1_ERRORS extern const char **para_errlist[]; /** \endcond */ +#define FSCK_ERRORS \ + PARA_ERROR(FSCK_SYNTAX, "fsck syntax error"), \ + PARA_ERROR(RANGE_VIOLATION, "range violation detected, very bad"), \ + PARA_ERROR(NOT_A_REGULAR_FILE, "not a regular file"), \ + + +#define OSL_ERRORS \ + PARA_ERROR(BAD_DB_DIR, "invalid database directory"), \ + PARA_ERROR(NO_COLUMN_DESC, "missing column description"), \ + PARA_ERROR(BAD_NAME, "invalid name for a column/table"), \ + PARA_ERROR(BAD_STORAGE_TYPE, "invalid storage type"), \ + PARA_ERROR(BAD_STORAGE_FLAGS, "invalid storage flags"), \ + PARA_ERROR(NO_COLUMN_NAME, "missing column name"), \ + PARA_ERROR(NO_COLUMNS, "at least one column required"), \ + PARA_ERROR(BAD_COLUMN_NAME, "invalid name for a table column"), \ + PARA_ERROR(NO_UNIQUE_RBTREE_COLUMN, "need at least one mapped column with OSL_UNIQE and OSL_RBTREE OSL"), \ + PARA_ERROR(NO_RBTREE_COL, "at least one column needs an rbtree"), \ + PARA_ERROR(DUPLICATE_COL_NAME, "column name given twice"), \ + PARA_ERROR(BAD_STORAGE_SIZE, "invalid storage size"), \ + PARA_ERROR(NO_COMPARE_FUNC, "missing compare function"), \ + PARA_ERROR(BAD_DATA_SIZE, "wrong data size for fixed-size column"), \ + PARA_ERROR(NOT_MAPPED, "file not mapped"), \ + PARA_ERROR(ALREADY_MAPPED, "file already mapped"), \ + PARA_ERROR(BAD_SIZE, "invalid size specified"), \ + PARA_ERROR(TRUNC, "failed to truncate file"), \ + PARA_ERROR(UNLINK, "failed to remove file"), \ + PARA_ERROR(NOTDIR, "error: not a directory"), \ + PARA_ERROR(BAD_TABLE, "table not open"), \ + PARA_ERROR(BAD_TABLE_DESC, "invalid table description"), \ + PARA_ERROR(RB_KEY_EXISTS, "key already exists in rbtree"), \ + PARA_ERROR(RB_KEY_NOT_FOUND, "key not found in rbtree"), \ + PARA_ERROR(BAD_ROW_NUM, "invalid row number"), \ + PARA_ERROR(INDEX_CORRUPTION, "index corruption detected"), \ + PARA_ERROR(INVALID_OBJECT, "reference to invalid object"), \ + PARA_ERROR(STAT, "can not stat file"), \ + PARA_ERROR(FSTAT, "fstat error"), \ + PARA_ERROR(RENAME, "rename failed"), \ + PARA_ERROR(EMPTY, "file empty"), \ + PARA_ERROR(MMAP, "mmap error"), \ + PARA_ERROR(MUNMAP, "munmap failed"), \ + PARA_ERROR(WRITE, "write error"), \ + PARA_ERROR(LSEEK, "lseek error"), \ + PARA_ERROR(BUSY, "table is busy"), \ + PARA_ERROR(SHORT_TABLE, "table too short"), \ + PARA_ERROR(NO_MAGIC, "missing table header magic"), \ + PARA_ERROR(VERSION_MISMATCH, "table version not suppoerted"), \ + PARA_ERROR(BAD_COLUMN_NUM, "invalid column number"), \ + PARA_ERROR(BAD_TABLE_FLAGS, "invalid flags in table description"), \ + PARA_ERROR(BAD_ROW, "invalid row"), \ + + +#define RBTREE_ERRORS \ + + +#define AFS_ERRORS \ + PARA_ERROR(BAD_TABLE_NAME, "invalid table"), \ + PARA_ERROR(INPUT_TOO_LARGE, "input too large for stdin command"), \ + PARA_ERROR(READ, "read error"), \ + PARA_ERROR(AFS_SYNTAX, "afs syntax error"), \ + + +#define MOOD_ERRORS \ + PARA_ERROR(MOOD_SYNTAX, "mood syntax error"), \ + PARA_ERROR(MOOD_REGEX, "invalid regular expression"), \ + PARA_ERROR(NO_MOOD, "no mood available"), \ + PARA_ERROR(MOOD_LOADED, "mood loaded"), \ + PARA_ERROR(MOOD_BUSY, "mood is in use"), \ + PARA_ERROR(NOT_ADMISSIBLE, "file is not admussible"), \ + + +#define ATTRIBUTE_ERRORS \ + PARA_ERROR(ATTR_SYNTAX, "attribute syntax error"), \ + PARA_ERROR(ATTR_EXISTS, "attribute already exists"), \ + PARA_ERROR(ATTR_TABLE_FULL, "attribute table full"), \ + PARA_ERROR(NO_ATTRIBUTES, "no attributes defined yet"), \ + +#define BLOB_ERRORS \ + PARA_ERROR(BLOB_SYNTAX, "blob syntax error"), \ + PARA_ERROR(DUMMY_ROW, "attempted to access blob dummy object"), \ + + +#define PLAYLIST_ERRORS \ + PARA_ERROR(PLAYLIST_SYNTAX, "playlist syntax error"), \ + PARA_ERROR(NO_PLAYLIST, "no valid playlist found"), \ + PARA_ERROR(PLAYLIST_LOADED, ""), /* not really an error */ \ + PARA_ERROR(PLAYLIST_EMPTY, "attempted to load empty playlist"), \ + + +#define AFT_ERRORS \ + PARA_ERROR(BAD_AFSI, "invaid afs info"), \ + PARA_ERROR(LOCALTIME, "localtime() failed"), \ + PARA_ERROR(STRFTIME, "strftime() failed"), \ + PARA_ERROR(BAD_PATH, "invalid path"), \ + PARA_ERROR(BAD_SORT, "invalid sorting method"), \ + PARA_ERROR(FNMATCH, "fnmatch error"), \ + PARA_ERROR(NO_MATCH, "no matches"), \ + PARA_ERROR(NO_AFHI, "audio format handler info required"), \ + PARA_ERROR(AFT_SYNTAX, "audio file table syntax error"), \ + PARA_ERROR(HASH_MISMATCH, "hash mismatch, consider re-add"), \ + + +#define USER_LIST_ERRORS \ + PARA_ERROR(USERLIST, "failed to open user list file"), \ + + +#define OSX_WRITE_ERRORS \ + PARA_ERROR(STREAM_FORMAT, "could not set stream format"), \ + PARA_ERROR(ADD_CALLBACK, "can not add callback"), \ + PARA_ERROR(OPEN_COMP, "OpenAComponent() error"), \ + PARA_ERROR(UNIT_INIT, "AudioUnitInitialize() error"), \ + PARA_ERROR(UNIT_START, "AudioUnitStart() error"), \ + PARA_ERROR(DEFAULT_COMP, "can not find default audio output component"), \ + + +#define AUDIOC_ERRORS \ + PARA_ERROR(AUDIOC_SYNTAX, "audioc syntax error"), \ + PARA_ERROR(AUDIOC_READ, "audioc read error"), \ + PARA_ERROR(AUDIOC_WRITE, "audioc write error"), \ + PARA_ERROR(INIT_SOCK_ADDR, "can not init socket"), \ + PARA_ERROR(AUDIOC_CONNECT, "audioc connect error"), \ + PARA_ERROR(AUDIOC_OVERRUN, "audioc buffer overrun"), \ + + + +#define CLIENT_COMMON_ERRORS \ + PARA_ERROR(CLIENT_SYNTAX, "syntax error"), \ + PARA_ERROR(INVALID_CHALLENGE, "did not receive valid challenge"), \ + PARA_ERROR(NO_CONFIG, "config file not found"), \ + PARA_ERROR(CLIENT_AUTH, "authentication failed"), \ + PARA_ERROR(SERVER_EOF, "connection closed by para_server"), \ + PARA_ERROR(INPUT_EOF, "end of input"), \ + PARA_ERROR(HANDSHAKE_COMPLETE, ""), /* not really an error */ \ + + #define SCHED_ERRORS \ PARA_ERROR(TASK_KILLED, "task killed"), \ PARA_ERROR(NO_SUCH_TASK, "task not found"), \ + PARA_ERROR(NOT_INITIALIZED, "scheduler not yet initialized"), \ #define STDIN_ERRORS \ @@ -131,31 +273,29 @@ extern const char **para_errlist[]; #define HTTP_RECV_ERRORS \ - PARA_ERROR(SEND_HTTP_REQUEST, "failed to send http request"), \ - PARA_ERROR(MISSING_OK, "did not receive OK message from peer"), \ - PARA_ERROR(HTTP_RECV_BUF, "did not receive buffer"), \ PARA_ERROR(HTTP_RECV_EOF, "http_recv: end of file"), \ + PARA_ERROR(HTTP_RECV_OVERRUN, "http_recv: outout buffer overrun"), \ #define RECV_ERRORS \ - PARA_ERROR(RECV_SELECT, "recv select error"), \ - PARA_ERROR(WRITE_STDOUT, "stdout write error"), \ + PARA_ERROR(RECV_SYNTAX, "recv syntax error"), \ #define RECV_COMMON_ERRORS \ - PARA_ERROR(RECV_SYNTAX, "recv syntax error"), \ #define AUDIOD_ERRORS \ - PARA_ERROR(WRITE_AUDIO_DATA, "failed to write audio data"), \ PARA_ERROR(NO_MORE_SLOTS, "no more empty slots"), \ PARA_ERROR(MISSING_COLON, "syntax error: missing colon"), \ PARA_ERROR(UNSUPPORTED_AUDIO_FORMAT, "given audio format not supported"), \ + PARA_ERROR(SIGNAL_CAUGHT, "caught signal"), \ + + +#define AUDIOD_COMMAND_ERRORS \ PARA_ERROR(CLIENT_WRITE, "client write error"), \ + PARA_ERROR(AUDIOD_SYNTAX, "syntax error"), \ PARA_ERROR(UCRED_PERM, "permission denied"), \ PARA_ERROR(INVALID_AUDIOD_CMD, "invalid command"), \ - PARA_ERROR(AUDIOD_SYNTAX, "syntax error"), \ - PARA_ERROR(STATUS_EOF, "server closed status connection"), \ #define FILTER_CHAIN_ERRORS \ @@ -203,12 +343,15 @@ extern const char **para_errlist[]; PARA_ERROR(SIGNAL_READ, "read error from signal pipe"), \ PARA_ERROR(WAITPID, "waitpid error"), \ PARA_ERROR(SIGNAL_PIPE, "failed to setup signal pipe"), \ - PARA_ERROR(SIGNAL_CAUGHT, "caught signal"), \ #define STRING_ERRORS \ PARA_ERROR(MKSTEMP, "mkstemp error: unable to create tmp file"), \ PARA_ERROR(FCHMOD, "fchmod error: can not set mode"), \ + PARA_ERROR(ATOI_OVERFLOW, "value too large"), \ + PARA_ERROR(STRTOLL, "unknown strtoll error"), \ + PARA_ERROR(ATOI_NO_DIGITS, "no digits found in string"), \ + PARA_ERROR(ATOI_JUNK_AT_END, "further characters after number"), \ #define EXEC_ERRORS \ @@ -217,23 +360,17 @@ extern const char **para_errlist[]; #define MP3_AFH_ERRORS \ - PARA_ERROR(FREAD, "fread error"), \ - PARA_ERROR(FSEEK, "fseek error"), \ PARA_ERROR(FRAME, "invalid mp3 frame"), \ PARA_ERROR(FRAME_LENGTH, "invalid frame length"), \ - PARA_ERROR(MP3_NO_FILE, "invalid mp3 file pointer"), \ PARA_ERROR(MP3_INFO, "could not read mp3 info"), \ - PARA_ERROR(MP3_REPOS, "mp3 repositioning error"), \ PARA_ERROR(HEADER_FREQ, "invalid header frequency"), \ PARA_ERROR(HEADER_BITRATE, "invalid header bitrate"), \ #define AAC_AFH_ERRORS \ - PARA_ERROR(AAC_REPOS, "aac repositioning error"), \ - PARA_ERROR(AAC_READ, "aac read error"), \ PARA_ERROR(STSZ, "did not find stcz atom"), \ PARA_ERROR(MP4ASC, "audio spec config error"), \ - PARA_ERROR(AAC_OVERRUN, "aac output buffer overrun"), \ + PARA_ERROR(AAC_AFH_INIT, "failed to init aac decoder"), \ #define AAC_COMMON_ERRORS \ @@ -247,21 +384,20 @@ extern const char **para_errlist[]; PARA_ERROR(STREAM_PAGEIN, "ogg stream page-in error (first page)"), \ PARA_ERROR(STREAM_PACKETOUT, "ogg stream packet-out error (first packet)"), \ PARA_ERROR(VORBIS, "vorbis synthesis header-in error (not vorbis?)"), \ - PARA_ERROR(OGG_NO_FILE, "invalid ogg file pointer"), \ - PARA_ERROR(OGG_OPEN, "ov_open error"), \ PARA_ERROR(OGG_INFO, "ov_info error"), \ - PARA_ERROR(OGG_REPOS, "ogg repositioning error"), \ + PARA_ERROR(OGG_VERSION, "unsupported ogg version"), \ + PARA_ERROR(OGG_BAD_HEADER, "invalid ogg vorbis header"), \ + PARA_ERROR(OGG_UNKNOWN_ERROR, "unknown ogg vorbis error"), \ -#define AFS_ERRORS \ +#define VSS_ERRORS \ + PARA_ERROR(BAD_AUDIO_FILE_SUFFIX, "unknown suffix"), \ PARA_ERROR(AUDIO_FORMAT, "audio format not recognized"), \ - PARA_ERROR(FSTAT, "failed to fstat() audio file"), \ + PARA_ERROR(CHUNK, "unable to get chunk"), \ -#define DB_ERRORS \ +#define AFS_COMMON_ERRORS \ PARA_ERROR(GETCWD, "can not get current working directory"), \ - PARA_ERROR(CHDIR, "can not change directory"), \ - PARA_ERROR(OPENDIR, "can not open directory"), \ PARA_ERROR(LSTAT, "lstat error"), \ @@ -275,12 +411,11 @@ extern const char **para_errlist[]; #define HTTP_SEND_ERRORS \ - PARA_ERROR(QUEUE, "packet queue overrun"), \ PARA_ERROR(WRITE_OK, "can not check whether fd is writable"), \ + PARA_ERROR(SEND_QUEUED_CHUNK, "failed to send queued chunk"), \ #define RANDOM_SELECTOR_ERRORS \ - PARA_ERROR(FILE_COUNT, "audio file count exceeded"), \ PARA_ERROR(NOTHING_FOUND, "no audio files found"), \ @@ -314,10 +449,10 @@ extern const char **para_errlist[]; PARA_ERROR(NO_AUDIO_FILE, "no audio file"), \ PARA_ERROR(BAD_CMD, "invalid command"), \ PARA_ERROR(PERM, "permission denied"), \ - PARA_ERROR(USERLIST, "failed to open user list file"), \ - PARA_ERROR(BAD_USER, "you don't exist. Go away."), \ PARA_ERROR(LOCK, "lock error"), \ PARA_ERROR(SENDER_CMD, "command not supported by this sender"), \ + PARA_ERROR(SERVER_CRASH, "para_server crashed -- can not live without it"), \ + PARA_ERROR(BAD_USER, "you don't exist. Go away."), \ #define PLAYLIST_SELECTOR_ERRORS \ @@ -335,15 +470,13 @@ extern const char **para_errlist[]; #define DCCP_ERRORS \ PARA_ERROR(DCCP_SOCKET, "can not create dccp socket"), \ - PARA_ERROR(DCCP_PACKET_SIZE, "failed to set dccp packet size"), \ - PARA_ERROR(DCCP_SERVICE, "could not get service code"), \ - PARA_ERROR(DCCP_RECV_EOF, "dccp_recv: end of file"), \ #define DCCP_RECV_ERRORS \ PARA_ERROR(ADDR_INFO, "getaddrinfo error"), \ PARA_ERROR(DCCP_OVERRUN, "dccp output buffer buffer overrun"), \ PARA_ERROR(DCCP_CONNECT, "dccp connect error"), \ + PARA_ERROR(DCCP_RECV_EOF, "dccp_recv: end of file"), \ #define DCCP_SEND_ERRORS \ @@ -355,6 +488,18 @@ extern const char **para_errlist[]; #define FD_ERRORS \ PARA_ERROR(F_GETFL, "failed to get fd flags"), \ PARA_ERROR(F_SETFL, "failed to set fd flags"), \ + PARA_ERROR(FGETS, "fgets error"), \ + PARA_ERROR(EXIST, "file or directory already exists"), \ + PARA_ERROR(ISDIR, "error: is a directory"), \ + PARA_ERROR(NOENT, "no such file or directory"), \ + PARA_ERROR(OPEN_PERM, "open error (permission denied)"), \ + PARA_ERROR(MKDIR_PERM, "mkdir error (permission denied)"), \ + PARA_ERROR(MKDIR, "failed to create directory"), \ + PARA_ERROR(CHDIR, "failed to change directory"), \ + PARA_ERROR(FCHDIR, "fchdir failed"), \ + PARA_ERROR(OPENDIR, "can not open directory"), \ + PARA_ERROR(NOSPC, "no space left on device"), \ + PARA_ERROR(OPEN, "failed to open file"), \ #define WRITE_ERRORS \ @@ -366,7 +511,7 @@ extern const char **para_errlist[]; PARA_ERROR(DELAY_TIMEOUT, "initial delay timeout"), \ -#define ALSA_WRITER_ERRORS \ +#define ALSA_WRITE_ERRORS \ PARA_ERROR(BROKEN_CONF, "Broken alsa configuration"), \ PARA_ERROR(ACCESS_TYPE, "alsa access type not available"), \ PARA_ERROR(SAMPLE_FORMAT, "sample format not available"), \ @@ -386,7 +531,7 @@ extern const char **para_errlist[]; PARA_ERROR(STOP_THRESHOLD, "snd_pcm_sw_params_set_stop_threshold() failed"), \ -#define FILE_WRITER_ERRORS \ +#define FILE_WRITE_ERRORS \ PARA_ERROR(FW_WRITE, "file writer write error"), \ PARA_ERROR(FW_OPEN, "file writer: can not open output file"), \ PARA_ERROR(FW_NO_FILE, "task started without open file"), \ @@ -400,6 +545,11 @@ extern const char **para_errlist[]; #define AACDEC_ERRORS \ PARA_ERROR(AACDEC_INIT, "failed to init aac decoder"), \ PARA_ERROR(AAC_DECODE, "aac decode error"), \ + PARA_ERROR(AAC_OVERRUN, "aac output buffer overrun"), \ + + +#define CHUNK_QUEUE_ERRORS \ + PARA_ERROR(QUEUE, "packet queue overrun"), \ /** @@ -472,7 +622,7 @@ extern const char **para_errlist[]; */ #define PARA_ERROR(err, msg) E_ ## err -#define SS_NAME(ss) para_errlist[ss]? para_errlist[ss][0] : "" +// #define SS_NAME(ss) para_errlist[ss]? para_errlist[ss][0] : "" /** \cond popcorn time */ SS_ENUM(GUI); @@ -487,6 +637,7 @@ SS_ENUM(ORTP_RECV); SS_ENUM(NET); SS_ENUM(RECV); SS_ENUM(AUDIOD); +SS_ENUM(AUDIOD_COMMAND); SS_ENUM(EXEC); SS_ENUM(SIGNAL); SS_ENUM(STRING); @@ -505,14 +656,14 @@ SS_ENUM(OGG_AFH); SS_ENUM(AAC_AFH); SS_ENUM(AAC_COMMON); SS_ENUM(SERVER); -SS_ENUM(AFS); +SS_ENUM(VSS); SS_ENUM(COMMAND); SS_ENUM(RANDOM_SELECTOR); SS_ENUM(PLAYLIST_SELECTOR); SS_ENUM(CRYPT); SS_ENUM(HTTP_SEND); SS_ENUM(ORTP_SEND); -SS_ENUM(DB); +SS_ENUM(AFS_COMMON); SS_ENUM(MYSQL_SELECTOR); SS_ENUM(IPC); SS_ENUM(DCCP); @@ -521,9 +672,27 @@ SS_ENUM(DCCP_SEND); SS_ENUM(FD); SS_ENUM(WRITE); SS_ENUM(WRITE_COMMON); -SS_ENUM(ALSA_WRITER); -SS_ENUM(FILE_WRITER); +SS_ENUM(ALSA_WRITE); +SS_ENUM(FILE_WRITE); +SS_ENUM(OSX_WRITE); SS_ENUM(RINGBUFFER); +SS_ENUM(CLIENT); +SS_ENUM(CLIENT_COMMON); +SS_ENUM(AUDIOC); +SS_ENUM(USER_LIST); +SS_ENUM(CHUNK_QUEUE); + +SS_ENUM(AFS); +SS_ENUM(OSL); +SS_ENUM(AFT); +SS_ENUM(MOOD); +SS_ENUM(SCORE); +SS_ENUM(ATTRIBUTE); +SS_ENUM(BLOB); +SS_ENUM(PLAYLIST); +SS_ENUM(SHA1); +SS_ENUM(RBTREE); +SS_ENUM(FSCK); /** \endcond */ #undef PARA_ERROR /* rest of the world only sees the error text */