draft-ietf-netmod-syslog-model-25.txt   draft-ietf-netmod-syslog-model-26.txt 
NETMOD WG C. Wildes, Ed. NETMOD WG C. Wildes, Ed.
Internet-Draft Cisco Systems Inc. Internet-Draft Cisco Systems Inc.
Intended status: Standards Track K. Koushik, Ed. Intended status: Standards Track K. Koushik, Ed.
Expires: September 13, 2018 Verizon Wireless Expires: September 14, 2018 Verizon Wireless
March 14, 2018 March 15, 2018
A YANG Data Model for Syslog Configuration A YANG Data Model for Syslog Configuration
draft-ietf-netmod-syslog-model-25 draft-ietf-netmod-syslog-model-26
Abstract Abstract
This document defines a YANG data model for the configuration of a This document defines a YANG data model for the configuration of a
syslog process. It is intended this model be used by vendors who syslog process. It is intended this model be used by vendors who
implement syslog in their systems. implement syslog in their systems.
The YANG model in this document conforms to the Network Management
Datastore Architecture defined in [draft-ietf-netmod-revised-
datastores].
Status of this Memo Status of this Memo
This Internet-Draft is submitted in full conformance with the This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79. provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/. Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on September 13, 2018. This Internet-Draft will expire on September 14, 2018.
Copyright Notice Copyright Notice
Copyright (c) 2018 IETF Trust and the persons identified as the Copyright (c) 2018 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents (http://trustee.ietf.org/ Provisions Relating to IETF Documents (http://trustee.ietf.org/
license-info) in effect on the date of publication of this document. license-info) in effect on the date of publication of this document.
Please review these documents carefully, as they describe your rights Please review these documents carefully, as they describe your rights
skipping to change at page 2, line 54 skipping to change at page 2, line 50
processes, applications or other syslog processes) and processes processes, applications or other syslog processes) and processes
them. The processing may involve logging to a local file, and/or them. The processing may involve logging to a local file, and/or
displaying on console, and/or relaying to syslog processes on other displaying on console, and/or relaying to syslog processes on other
machines. The processing is determined by the "facility" that machines. The processing is determined by the "facility" that
originated the message and the "severity" assigned to the message by originated the message and the "severity" assigned to the message by
the facility. the facility.
Such definitions of syslog protocol are defined in [RFC5424], and are Such definitions of syslog protocol are defined in [RFC5424], and are
used in this RFC. used in this RFC.
The YANG model in this document conforms to the Network Management
Datastore Architecture defined in [draft-ietf-netmod-revised-
datastores].
1.1. Requirements Language 1.1. Requirements Language
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in BCP "OPTIONAL" in this document are to be interpreted as described in BCP
14 [RFC2119] [RFC8174] when, and only when, they appear in all 14 [RFC2119] [RFC8174] when, and only when, they appear in all
capitals, as shown here. capitals, as shown here.
1.2. Terminology 1.2. Terminology
The term "originator" is defined in [RFC5424]: an "originator" The term "originator" is defined in [RFC5424]: an "originator"
skipping to change at page 9, line 5 skipping to change at page 9, line 5
3. Syslog YANG Module 3. Syslog YANG Module
3.1. The ietf-syslog Module 3.1. The ietf-syslog Module
This module imports typedefs from [RFC6991], This module imports typedefs from [RFC6991],
[I-D.ietf-netmod-rfc7223bis], groupings from [I-D.ietf-netmod-rfc7223bis], groupings from
[I-D.ietf-netconf-keystore], and [I-D.ietf-netconf-keystore], and
[I-D.ietf-netconf-tls-client-server], and it references [RFC5424], [I-D.ietf-netconf-tls-client-server], and it references [RFC5424],
[RFC5425], [RFC5426], [RFC5848], [RFC8089], [RFC8174], and [RFC5425], [RFC5426], [RFC5848], [RFC8089], [RFC8174], and
[Std-1003.1-2008]. [Std-1003.1-2008].
<CODE BEGINS> file "ietf-syslog@2018-03-14.yang" <CODE BEGINS> file "ietf-syslog@2018-03-15.yang"
module ietf-syslog { module ietf-syslog {
yang-version 1.1; yang-version 1.1;
namespace "urn:ietf:params:xml:ns:yang:ietf-syslog"; namespace "urn:ietf:params:xml:ns:yang:ietf-syslog";
prefix syslog; prefix syslog;
import ietf-inet-types { import ietf-inet-types {
prefix inet; prefix inet;
reference reference
"RFC 6991: Common YANG Data Types"; "RFC 6991: Common YANG Data Types";
skipping to change at page 10, line 21 skipping to change at page 10, line 21
The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL
NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'MAY', and NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'MAY', and
'OPTIONAL' in the module text are to be interpreted as 'OPTIONAL' in the module text are to be interpreted as
described in RFC 2119 (http://tools.ietf.org/html/rfc2119). described in RFC 2119 (http://tools.ietf.org/html/rfc2119).
This version of this YANG module is part of RFC zzzz This version of this YANG module is part of RFC zzzz
(http://tools.ietf.org/html/rfczzzz); see the RFC itself for (http://tools.ietf.org/html/rfczzzz); see the RFC itself for
full legal notices."; full legal notices.";
revision 2018-03-14 { revision 2018-03-15 {
description description
"Initial Revision"; "Initial Revision";
reference reference
"RFC zzzz: Syslog YANG Model"; "RFC zzzz: Syslog YANG Model";
} }
feature console-action { feature console-action {
description description
"This feature indicates that the local console action is "This feature indicates that the local console action is
supported."; supported.";
skipping to change at page 31, line 8 skipping to change at page 31, line 8
The syslog/file/log-file/file-rotation container contains The syslog/file/log-file/file-rotation container contains
configuration parameters for syslog file rotation. This section configuration parameters for syslog file rotation. This section
describes how these fields might be used by an implementer to name describes how these fields might be used by an implementer to name
syslog files in a rotation process. This information is offered as syslog files in a rotation process. This information is offered as
an informative guide only. an informative guide only.
When an active syslog file with a name specified by log-file/name, When an active syslog file with a name specified by log-file/name,
reaches log-file/max-file-size and/or syslog events arrive after the reaches log-file/max-file-size and/or syslog events arrive after the
period specified by log-file/rollover, the logging system can close period specified by log-file/rollover, the logging system can close
the file, can compresses it, and can name the archive file <log-file/ the file, can compress it, and can name the archive file <log-file/
name>.0.gz. The logging system can then open a new active syslog name>.0.gz. The logging system can then open a new active syslog
file <log-file/name>. file <log-file/name>.
When the new syslog file reaches either of the size limits referenced When the new syslog file reaches either of the size limits referenced
above, <log-file/name>.0.gz can be renamed <log-file/name>.1.gz and above, <log-file/name>.0.gz can be renamed <log-file/name>.1.gz and
the new syslog file can be closed, compressed and renamed <log-file/ the new syslog file can be closed, compressed and renamed <log-file/
name>.0.gz. Each time that a new syslog file is closed, each of the name>.0.gz. Each time that a new syslog file is closed, each of the
prior syslog archive files named <log-file/name>.<n>.gz can be prior syslog archive files named <log-file/name>.<n>.gz can be
renamed to <log-file/name>.<n + 1>.gz. renamed to <log-file/name>.<n + 1>.gz.
Removal of archive log files could occur when either or both: Removal of archive log files could occur when either or both:
- log-file/number-of-files specified - the logging system can create - log-file/number-of-files specified - the logging system can create
up to log-file/number-of-files syslog archive files after which, the up to log-file/number-of-files syslog archive files after which, the
contents of the last archived file could be overwritten. contents of the oldest archived file could be overwritten.
- log-file/retention specified - the logging system can remove those - log-file/retention specified - the logging system can remove those
syslog archive files whose file expiration time (file creation time syslog archive files whose file expiration time (file creation time
plus the specified log-file/retention time) is prior to the current plus the specified log-file/retention time) is prior to the current
time. time.
Authors' Addresses Authors' Addresses
Clyde Wildes, editor Clyde Wildes, editor
Cisco Systems Inc. Cisco Systems Inc.
 End of changes. 9 change blocks. 
12 lines changed or deleted 12 lines changed or added

This html diff was produced by rfcdiff 1.46. The latest version is available from http://tools.ietf.org/tools/rfcdiff/