journal_abort(9) [centos man page]

JOURNAL_ABORT(9)					     The Linux Journalling API						  JOURNAL_ABORT(9)

NAME

       journal_abort - Shutdown the journal immediately.

SYNOPSIS

       void journal_abort(journal_t * journal, int errno);

ARGUMENTS

       journal
	   the journal to shutdown.

       errno
	   an error number to record in the journal indicating the reason for the shutdown.

DESCRIPTION

       Perform a complete, immediate shutdown of the ENTIRE journal (not of a single transaction). This operation cannot be undone without closing
       and reopening the journal.

       The journal_abort function is intended to support higher level error recovery mechanisms such as the ext2/ext3 remount-readonly error mode.

       Journal abort has very specific semantics. Any existing dirty, unjournaled buffers in the main filesystem will still be written to disk by
       bdflush, but the journaling mechanism will be suspended immediately and no further transaction commits will be honoured.

       Any dirty, journaled buffers will be written back to disk without hitting the journal. Atomicity cannot be guaranteed on an aborted
       filesystem, but we _do_ attempt to leave as much data as possible behind for fsck to use for cleanup.

       Any attempt to get a new transaction handle on a journal which is in ABORT state will just result in an -EROFS error return. A journal_stop
       on an existing handle will return -EIO if we have entered abort state during the update.

       Recursive transactions are not disturbed by journal abort until the final journal_stop, which will receive the -EIO error.

       Finally, the journal_abort call allows the caller to supply an errno which will be recorded (if possible) in the journal superblock. This
       allows a client to record failure conditions in the middle of a transaction without having to complete the transaction to record the
       failure to disk. ext3_error, for example, now uses this functionality.

       Errors which originate from within the journaling layer will NOT supply an errno; a null errno implies that absolutely no further writes
       are done to the journal (unless there are any already in progress).

AUTHORS

       Roger Gammans <rgammans@computer-surgery.co.uk>
	   Author.

       Stephen Tweedie <sct@redhat.com>
	   Author.

COPYRIGHT

Kernel Hackers Manual 3.10					     June 2014							  JOURNAL_ABORT(9)

Check Out this Related Man Page

SD_JOURNAL_GET_CATALOG(3)				      sd_journal_get_catalog					 SD_JOURNAL_GET_CATALOG(3)

NAME

       sd_journal_get_catalog, sd_journal_get_catalog_for_message_id - Retrieve message catalog entry

SYNOPSIS

       #include <systemd/sd-journal.h>

       int sd_journal_get_catalog(sd_journal* j, char** ret);

       int sd_journal_get_catalog_for_message_id(sd_id128_t id, char** ret);

DESCRIPTION

       sd_journal_get_catalog() retrieves a message catalog entry for the current journal entry. This will look up an entry in the message catalog
       by using the "MESSAGE_ID=" field of the current journal entry. Before returning the entry all journal field names in the catalog entry text
       enclosed in "@" will be replaced by the respective field values of the current entry. If a field name referenced in the message catalog
       entry does not exist, in the current journal entry, the "@" will be removed, but the field name otherwise left untouched.

       sd_journal_get_catalog_for_message_id() works similar to sd_journal_get_catalog() but the entry is looked up by the specified message ID
       (no open journal context is necessary for this), and no field substitution is performed.

       For more information about the journal message catalog please refer to the Journal Message Catalogs[1] documentation page.

RETURN VALUE

       sd_journal_get_catalog() and sd_journal_get_catalog_for_message_id() return 0 on success or a negative errno-style error code. If no
       matching message catalog entry is found, -ENOENT is returned.

       On successful return, ret points to a new string, which must be freed with free(3).

NOTES

       The sd_journal_get_catalog() and sd_journal_get_catalog_for_message_id() interfaces are available as a shared library, which can be
       compiled and linked to with the libsystemd-journal pkg-config(1) file.

SEE ALSO

       systemd(1), systemd.journal-fields(7), sd-journal(3), sd_journal_open(3), sd_journal_next(3), sd_journal_get_data(3)malloc(3)

NOTES

	1. Journal Message Catalogs
	   http://www.freedesktop.org/wiki/Software/systemd/catalog

systemd 208														 SD_JOURNAL_GET_CATALOG(3)

Linux and UNIX Man Pages

journal_abort(9) [centos man page]

Check Out this Related Man Page