]> git.ipfire.org Git - thirdparty/suricata-update.git/log
thirdparty/suricata-update.git
2 years agochangelog: update 339/head
Jason Ish [Fri, 16 Feb 2024 16:57:33 +0000 (10:57 -0600)] 
changelog: update

2 years agoupdate min-version required
Shivani Bhardwaj [Thu, 16 Nov 2023 10:11:36 +0000 (15:41 +0530)] 
update min-version required

2 years agogithub: update links in the PR template
Juliana Fajardini [Wed, 18 Oct 2023 20:14:42 +0000 (17:14 -0300)] 
github: update links in the PR template

Links were still pointing to Redmine and suricata-ids.

2 years agomisc: fix (more) escape warnings in re patterns
Jason Ish [Fri, 16 Feb 2024 16:55:16 +0000 (10:55 -0600)] 
misc: fix (more) escape warnings in re patterns

2 years agogithub-ci: cancel on push, read only permissions
Jason Ish [Thu, 15 Feb 2024 17:00:09 +0000 (11:00 -0600)] 
github-ci: cancel on push, read only permissions

2 years agogithub-ci: add fedora 39, remove fedora 37
Jason Ish [Thu, 15 Feb 2024 16:58:44 +0000 (10:58 -0600)] 
github-ci: add fedora 39, remove fedora 37

2 years agodoc: add a readthedocs configuration file
Jason Ish [Thu, 15 Feb 2024 16:54:39 +0000 (10:54 -0600)] 
doc: add a readthedocs configuration file

2 years agomisc: fix escape warnings in re patterns
Jason Ish [Thu, 15 Feb 2024 16:50:23 +0000 (10:50 -0600)] 
misc: fix escape warnings in re patterns

2 years agotox: test on python 3.9 -> python 3.11
Jason Ish [Thu, 15 Feb 2024 16:50:05 +0000 (10:50 -0600)] 
tox: test on python 3.9 -> python 3.11

2 years agodatasets: fix parsing "load" when preceded by a space.
Jason Ish [Thu, 15 Feb 2024 16:43:08 +0000 (10:43 -0600)] 
datasets: fix parsing "load" when preceded by a space.

Ticket: #6777

2 years agoversion: 1.3.1dev0
Jason Ish [Fri, 16 Feb 2024 16:49:49 +0000 (10:49 -0600)] 
version: 1.3.1dev0

2 years agoversion, changelog: 1.3.0 1.3.0
Jason Ish [Fri, 7 Jul 2023 17:38:45 +0000 (11:38 -0600)] 
version, changelog: 1.3.0

2 years agoconfig: prefer configuration specified files 330/head
Jason Ish [Tue, 4 Jul 2023 18:56:08 +0000 (12:56 -0600)] 
config: prefer configuration specified files

Suricata-Update was preferring the existence of "disable.conf" in
$sysconfdir over it be specified in the update.yaml.

Refactor the auto-conf to only search and apply the default
$sysconfdir files if they don't already exist in the config.

Additonally, now that the default, if not set or found will be none,
log a warning if a specific configuration file is not found instead of
silently ignoring.

Ticket: #6172

2 years agogithub-ci: update debian tests
Jason Ish [Tue, 4 Jul 2023 20:19:28 +0000 (14:19 -0600)] 
github-ci: update debian tests

- Add Debian 11 and 12
- Remove Debian 9

2 years agogithub-ci: remove ubuntu 16.04 test
Jason Ish [Tue, 4 Jul 2023 20:17:30 +0000 (14:17 -0600)] 
github-ci: remove ubuntu 16.04 test

Ubuntu 16.04 is now longer supported.

2 years agogithub-ci: update fedora tests
Jason Ish [Tue, 4 Jul 2023 20:14:57 +0000 (14:14 -0600)] 
github-ci: update fedora tests

Use Fedora 38 and 37 instead of 36 and 35.

3 years agoversion: 1.3.0rc1 1.3.0rc1
Jason Ish [Mon, 30 Jan 2023 16:50:37 +0000 (10:50 -0600)] 
version: 1.3.0rc1

3 years agoindex: update embedded index
Jason Ish [Thu, 26 Jan 2023 22:40:43 +0000 (16:40 -0600)] 
index: update embedded index

Now pretty.

3 years agoindex: embed pretty printed version of index
Jason Ish [Tue, 29 Nov 2022 17:45:50 +0000 (11:45 -0600)] 
index: embed pretty printed version of index

This will allow for easier reviewing of diffs.

3 years agochangelog: sync with 1.2.x branch
Jason Ish [Thu, 26 Jan 2023 22:36:58 +0000 (16:36 -0600)] 
changelog: sync with 1.2.x branch

3 years agodoc: now bundled with all versions of Suricata 326/head
Jason Ish [Wed, 30 Nov 2022 15:29:48 +0000 (09:29 -0600)] 
doc: now bundled with all versions of Suricata

Also recommend its best installed as bundled with Suricata.

3 years agoindex: update embedded index
Jason Ish [Fri, 25 Nov 2022 15:34:06 +0000 (09:34 -0600)] 
index: update embedded index

3 years agomatching: match on rule metadata
Jason Ish [Sat, 29 Oct 2022 04:55:20 +0000 (22:55 -0600)] 
matching: match on rule metadata

Allow metadata matching for enable and disable. For example:

    metadata: deployment perimeter

will match rules with "metadata: deployment Perimeter".

Match is case insensitive.

Ticket: #5561

3 years agoupdate: allow index "checksum" value to be a url
Jason Ish [Wed, 23 Nov 2022 18:04:10 +0000 (12:04 -0600)] 
update: allow index "checksum" value to be a url

If the checksum field in the index is a string, use it as the checksum
URL. This allows a source to specify a custom checksum URL instead of
the derived ".md5" URL.

Ticket: #5684

3 years agosource: better error if source spec missing "source" keyword
Jason Ish [Wed, 23 Nov 2022 22:47:35 +0000 (16:47 -0600)] 
source: better error if source spec missing "source" keyword

Related ticket: #5141

3 years agochangelog: sync with master-1.2.x
Jason Ish [Wed, 23 Nov 2022 17:05:36 +0000 (11:05 -0600)] 
changelog: sync with master-1.2.x

As no 1.3.0 releases have been made up, cleanup the changelog.

3 years agogithub-ci: fix pytest on MacOS
Jason Ish [Wed, 23 Nov 2022 18:15:10 +0000 (12:15 -0600)] 
github-ci: fix pytest on MacOS

3 years agogithub-ci: add Ubuntu 22.04 test
Jason Ish [Wed, 21 Sep 2022 17:03:49 +0000 (11:03 -0600)] 
github-ci: add Ubuntu 22.04 test

3 years agogithub-ci: replace Fedora 34 test with Fedora 36
Jason Ish [Wed, 21 Sep 2022 16:56:47 +0000 (10:56 -0600)] 
github-ci: replace Fedora 34 test with Fedora 36

Fedora 34 is EOL.

3 years agogithub-ci: add almalinux 9 build
Jason Ish [Wed, 21 Sep 2022 16:48:43 +0000 (10:48 -0600)] 
github-ci: add almalinux 9 build

At this time, tox and pytest don't install cleanly from packages on
the RHEL spinoffs, so just do the integration tests for now.

3 years agoindex: update embedded index
Jason Ish [Wed, 21 Sep 2022 21:42:56 +0000 (15:42 -0600)] 
index: update embedded index

3 years agotests/docker: remove ubuntu 16.04 build, EOL 317/head
Jason Ish [Wed, 31 Aug 2022 20:07:58 +0000 (14:07 -0600)] 
tests/docker: remove ubuntu 16.04 build, EOL

3 years agoentry point: update sys.path for non-distutils install 315/head
Jason Ish [Tue, 3 May 2022 19:11:03 +0000 (13:11 -0600)] 
entry point: update sys.path for non-distutils install

When bundled with Suricata, Suricata-Update will not be installed with
distutils/setuptools and will be installed in a custom location. Update
the search path for these changes.

This will still work correctly if installed from pip, or running from a
custom directory not bundled with Suricata.

Issue: #5313

3 years agoRemove line of debug output.
Jason Ish [Tue, 19 Apr 2022 21:37:10 +0000 (15:37 -0600)] 
Remove line of debug output.

3 years agochangelog: update 313/head
Jason Ish [Thu, 14 Apr 2022 15:08:06 +0000 (09:08 -0600)] 
changelog: update

3 years agoBetter URL fail message on with --fail.
Jason Ish [Fri, 15 Apr 2022 15:24:58 +0000 (09:24 -0600)] 
Better URL fail message on with --fail.

If --fail, we wil not use the cached version.

3 years agomain: add fail option and handle it
Shivani Bhardwaj [Mon, 27 Dec 2021 17:27:50 +0000 (22:57 +0530)] 
main: add fail option and handle it

Ticket 4579

3 years agomain: use format for error strings
Shivani Bhardwaj [Mon, 27 Dec 2021 17:22:24 +0000 (22:52 +0530)] 
main: use format for error strings

3 years agoDon't fail when source removed from index.
Jason Ish [Thu, 14 Apr 2022 15:54:30 +0000 (09:54 -0600)] 
Don't fail when source removed from index.

Instead of failing when an enabled source is no longer in the index, log
an error and continue onto the next source.

Ticket 5269

3 years agomodify: metadata-add filter
Jason Ish [Tue, 29 Mar 2022 23:21:36 +0000 (17:21 -0600)] 
modify: metadata-add filter

A new addition to `modify.conf` that allows for adding a new metadata.

Example configuration lines:
  metadata-add re:"SURICATA STREAM" "evebox-action" "archive"
  metadata-add 2010646 "evebox-action" "archive"

Matching rules will have a new `metadata` section added onto the end of
the rule.

Ticket #5221

3 years agodatasets: dataset handling for --local files
Jason Ish [Mon, 11 Apr 2022 19:53:24 +0000 (13:53 -0600)] 
datasets: dataset handling for --local files

Look for datasets on the filesystem when referenced from rules loaded
with "--local".

3 years agodatasets: disable rule if file not found
Jason Ish [Fri, 1 Apr 2022 16:34:03 +0000 (10:34 -0600)] 
datasets: disable rule if file not found

If a dataset file is not found for load, print a warning and disable the
rule. This will allow Suricata to pass the -T test so the working rules
are updated instead of rolling back.

3 years agodatasets: rewrite dataset filenames to a hash of the filename
Jason Ish [Tue, 29 Mar 2022 06:38:58 +0000 (00:38 -0600)] 
datasets: rewrite dataset filenames to a hash of the filename

Prevents dataset filenames from different rulesets that share the same
name from overwriting each other.

3 years agodatasets: fix path handling issues
Jason Ish [Tue, 29 Mar 2022 06:00:48 +0000 (00:00 -0600)] 
datasets: fix path handling issues

3 years agohandle dataset files properly
Shivani Bhardwaj [Thu, 10 Feb 2022 13:20:06 +0000 (18:50 +0530)] 
handle dataset files properly

- Cover edge cases for invalid dataset rules
- Handle "state" attribute
- Make checks more robust

Ticket 5010

3 years agoRespect Suricata's install location when loading config.
Jason Ish [Wed, 30 Mar 2022 21:00:54 +0000 (15:00 -0600)] 
Respect Suricata's install location when loading config.

During startup change the default locations of S-U configuration files
(enable.conf, disable.conf, etc) to be relative to the installed
Suricata's --sysconfdir, but only if they exist.  This keeps the
fallback behaviour to /etc/suricata for now.

Ticket #4374

3 years agochangelog: add fix for issue 4373
Jason Ish [Mon, 28 Mar 2022 22:23:57 +0000 (16:23 -0600)] 
changelog: add fix for issue 4373

3 years agocheckversions: fix wrong version checks
Shivani Bhardwaj [Wed, 29 Dec 2021 10:53:57 +0000 (16:23 +0530)] 
checkversions: fix wrong version checks

Ticket 4373

3 years agogithub-ci: update fedora tests to f34 and f35
Jason Ish [Mon, 28 Mar 2022 22:06:58 +0000 (16:06 -0600)] 
github-ci: update fedora tests to f34 and f35

3 years agogithub-ci: convert centos 8 build to almalinux 8
Jason Ish [Mon, 28 Mar 2022 22:04:32 +0000 (16:04 -0600)] 
github-ci: convert centos 8 build to almalinux 8

4 years agochangelog: update
Jason Ish [Fri, 7 Jan 2022 18:04:48 +0000 (12:04 -0600)] 
changelog: update

4 years agoAdd warning to update sources if no index found
Tharushi Jayasekara [Thu, 8 Oct 2020 16:46:21 +0000 (22:16 +0530)] 
Add warning to update sources if no index found

Don't automatically update the sources on list-sources
if it does not exist. Instead just use the bundled version.

Ticket #3249.

4 years agohelp output: hide advanced options behind a flag
Tharushi Jayasekara [Thu, 15 Oct 2020 13:34:26 +0000 (19:04 +0530)] 
help output: hide advanced options behind a flag

Cleaning up the suricata help output and hiding the extra options
behind a "--show-advanced" option.

Hidden options are:

* --user-agent <user-agent>
* --no-check-certificate
* --yaml-fragment <filename>
* --url <url>
* --local <path>
* --sid-msg-map <filename>
* --sid-msg-map-2 <filename>
* --ignore <pattern>
* --no-ignore
* --threshold-in <filename>
* --threshold-out <filename>
* --dump-sample-configs
* --etopen
* --reload-command <command>
* --test-command <command>
* --no-merge

Ticket #3974.

4 years agodoc: add --show-advanced to common options
Tharushi Jayasekara [Sat, 17 Oct 2020 04:26:00 +0000 (09:56 +0530)] 
doc: add --show-advanced to common options

Ticket #3974.

4 years agologging: Improve flowbit logs
Riju [Fri, 16 Oct 2020 20:37:13 +0000 (02:07 +0530)] 
logging: Improve flowbit logs

Add and update debug logs for flowbit requirements to display pass

Ticket #3205.

4 years agotrivial typo in comment
Joe Atzberger [Thu, 18 Nov 2021 23:30:19 +0000 (18:30 -0500)] 
trivial typo in comment

4 years agochangelog: update
Jason Ish [Wed, 5 Jan 2022 17:42:37 +0000 (11:42 -0600)] 
changelog: update

4 years agoFix counter accuracy.
Jason Ish [Wed, 29 Dec 2021 17:04:25 +0000 (11:04 -0600)] 
Fix counter accuracy.

Instead of counting how many modifications took place, just
count the number of rules that were modified.

4 years agoFix multiple modifications not having an affect.
Jason Ish [Wed, 29 Dec 2021 16:33:42 +0000 (10:33 -0600)] 
Fix multiple modifications not having an affect.

In the case where multiple modifications changed a rule (drop included),
only the last modification took affect.

This is due to the modifications each being done on a clean version of
the rule, rather than the previously modified version of the rule.

Ticket #4259

4 years agotests: add integration tests for multiple modifications
Jason Ish [Wed, 29 Dec 2021 18:51:23 +0000 (12:51 -0600)] 
tests: add integration tests for multiple modifications

4 years agointegration tests: format
Jason Ish [Wed, 29 Dec 2021 17:09:11 +0000 (11:09 -0600)] 
integration tests: format

4 years agoindex: allow custom url for embedded index update
Jason Ish [Thu, 28 Oct 2021 15:10:11 +0000 (09:10 -0600)] 
index: allow custom url for embedded index update

4 years agoDoc: Improve documentation of Suricata reload.
Andreas Dolp [Mon, 26 Jul 2021 19:44:09 +0000 (21:44 +0200)] 
Doc: Improve documentation of Suricata reload.

Redmine issue: https://redmine.openinfosecfoundation.org/issues/4564

4 years agodoc: fix formatting error
Jason Ish [Thu, 7 Oct 2021 19:16:49 +0000 (13:16 -0600)] 
doc: fix formatting error

4 years agochangelog: update 282/head
Jason Ish [Thu, 7 Oct 2021 18:22:00 +0000 (12:22 -0600)] 
changelog: update

4 years agoAllow more characters in the custom headers
JacobRoed [Wed, 22 Sep 2021 07:14:33 +0000 (09:14 +0200)] 
Allow more characters in the custom headers

Allow more characters in the custom header regular expression to
allow for Oauth2 tokens.

Feature #4701.

[Commit message rewritten by jish@oisf.net with permission]

4 years agotests: fix checksum test for new argument type
Jason Ish [Thu, 7 Oct 2021 18:34:25 +0000 (12:34 -0600)] 
tests: fix checksum test for new argument type

4 years agoUse HTTP-Headers for checksum request
Jascha Sticher [Fri, 16 Jul 2021 13:15:29 +0000 (15:15 +0200)] 
Use HTTP-Headers for checksum request

4 years agochangelog: update 275/head 281/head
Jason Ish [Tue, 18 May 2021 06:01:29 +0000 (00:01 -0600)] 
changelog: update

4 years agotesting: remove python 3.5, add python 3.8
Jason Ish [Tue, 18 May 2021 05:54:40 +0000 (23:54 -0600)] 
testing: remove python 3.5, add python 3.8

Python 3.5 has been end of lifed.

4 years agoconf: allow no-test in configuration file
Jason Ish [Tue, 18 May 2021 05:15:26 +0000 (23:15 -0600)] 
conf: allow no-test in configuration file

If no-test was set in the configuration file, it was always
being overridden by the command, even if not set on the command
line. This change allow no-test to be set in the configuration file
like:

no-test: true

Redmine issue:
https://redmine.openinfosecfoundation.org/versions/168

4 years agochangelog: update
Jason Ish [Tue, 13 Apr 2021 19:37:44 +0000 (13:37 -0600)] 
changelog: update

4 years agogithub-ci: add Ubuntu 20.04
Jason Ish [Tue, 13 Apr 2021 19:34:12 +0000 (13:34 -0600)] 
github-ci: add Ubuntu 20.04

4 years agogithub-ci: add fedora 33, remove fedora 31 (eol)
Jason Ish [Tue, 13 Apr 2021 19:32:42 +0000 (13:32 -0600)] 
github-ci: add fedora 33, remove fedora 31 (eol)

4 years agotravis-ci: remove, appears they haven't been building
Jason Ish [Tue, 13 Apr 2021 19:31:33 +0000 (13:31 -0600)] 
travis-ci: remove, appears they haven't been building

And GitHub CI has all these tests covered.

4 years agotests: add integration test for --http-header
Jason Ish [Tue, 13 Apr 2021 19:23:34 +0000 (13:23 -0600)] 
tests: add integration test for --http-header

4 years agoHTTP BasicAuth support.
Andreas Dolp [Thu, 25 Feb 2021 18:23:09 +0000 (19:23 +0100)] 
HTTP BasicAuth support.

Allow whitespaces in entire HTTP header value.

This enables HTTP Basic Authentication.

Redmine issue:
https://redmine.openinfosecfoundation.org/issues/4362

4 years agoversion: 1.3.0dev0
Jason Ish [Tue, 13 Apr 2021 19:13:45 +0000 (13:13 -0600)] 
version: 1.3.0dev0

4 years agoversion: 1.2.1 271/head 1.2.1
Jason Ish [Tue, 23 Feb 2021 04:54:11 +0000 (22:54 -0600)] 
version: 1.2.1

4 years agodoc: remove --merged option
Jason Ish [Tue, 23 Feb 2021 04:48:42 +0000 (22:48 -0600)] 
doc: remove --merged option

This option was never implemented and is an artifact of the tools
suricata-update was based on.

Redmine issue:
https://redmine.openinfosecfoundation.org/issues/4215

5 years agochangelog: update
Jason Ish [Wed, 17 Feb 2021 15:35:32 +0000 (09:35 -0600)] 
changelog: update

5 years agofix: fix --no-merge option 270/head
Jason [Mon, 15 Feb 2021 22:35:27 +0000 (16:35 -0600)] 
fix: fix --no-merge option

The no-merge handling was not updated when the file storage
was converted to a list causing it to fail.

Also add a --no-merge test to our integration test.

Fixes issue:
https://redmine.openinfosecfoundation.org/issues/4324

5 years agogithub-ci: fix MacOS test 269/head
Jason Ish [Wed, 27 Jan 2021 21:32:14 +0000 (15:32 -0600)] 
github-ci: fix MacOS test

Make sure Python 3 is used.

5 years agogithub-ci: remove CentOS 6 build
Jason Ish [Wed, 27 Jan 2021 21:29:29 +0000 (15:29 -0600)] 
github-ci: remove CentOS 6 build

CentOS 6 has been end of lifed.

5 years ago1.2.0: update version and changelog 268/head 1.2.0
Jason Ish [Mon, 5 Oct 2020 15:00:01 +0000 (09:00 -0600)] 
1.2.0: update version and changelog

5 years agodoc: update quick start to be current 255/head
Jason Ish [Mon, 21 Sep 2020 20:43:06 +0000 (14:43 -0600)] 
doc: update quick start to be current

5 years agodoc: disable default code formatting for code blocks
Jason Ish [Mon, 21 Sep 2020 20:42:04 +0000 (14:42 -0600)] 
doc: disable default code formatting for code blocks

Code blocks were by default being highlighted as Python, but
for Suricata-Update most code blocks are command lines, so
disable language highlighting by default.

5 years ago1.2.0rc2 254/head 1.2.0rc2
Jason Ish [Wed, 9 Sep 2020 22:22:57 +0000 (16:22 -0600)] 
1.2.0rc2

5 years agoHandle obsolete sources. 253/head
Jason Ish [Wed, 9 Sep 2020 19:32:59 +0000 (13:32 -0600)] 
Handle obsolete sources.

An obsolete source is a source that remains in the index but
is otherwise non-functional.

Much like deprecated sources it won't be displayed in list-sources
without the --all flag.

Obsolete sources will never be fetched. Instead a warning will be
printed with the obsolete reason.

5 years agoHandle deprecated sources in index.
Jason Ish [Wed, 9 Sep 2020 19:27:40 +0000 (13:27 -0600)] 
Handle deprecated sources in index.

Handle sources that have been deprecated in the index.

Deprecated sources will not be display with "list-sources" unless
the (new) --all flag is provided.

Also, warn the user if they are using a deprecated source with
the reason.

5 years agofix message containing tuple 252/head
Shivani Bhardwaj [Thu, 3 Sep 2020 15:42:56 +0000 (21:12 +0530)] 
fix message containing tuple

5 years agoallow re-enabling disabled sources
Shivani Bhardwaj [Mon, 24 Aug 2020 08:30:25 +0000 (14:00 +0530)] 
allow re-enabling disabled sources

Closes redmine ticket 3843.

5 years agolist-sources: keep list-enabled-sources as an alias
Jason Ish [Wed, 2 Sep 2020 21:29:10 +0000 (15:29 -0600)] 
list-sources: keep list-enabled-sources as an alias

Keep list-enabled-sources for backwards compatibility.

5 years agodataset parsing: handle spaces between ","
Jason Ish [Sat, 22 Aug 2020 05:00:56 +0000 (23:00 -0600)] 
dataset parsing: handle spaces between ","

Fix dataset parsing so the filename can be parsed from:

  dataset:isset, sslbl, type md5, load sslbl-fingerprints.md5;

5 years agoLoad files into list, not dict to keep duplicate filenames
Jason Ish [Wed, 8 Jul 2020 22:52:12 +0000 (16:52 -0600)] 
Load files into list, not dict to keep duplicate filenames

By loading all downloaded rule files into the same dict, filenames
that are the same cause other files to be lost, and the content
may be different.

Instead use of list objects that tracks the filename and the content
to avoid losing the contents of a filename that already exists.

If the contents is duplicated, the rule deduplication process
will catch that.

Redmine ticket:
https://redmine.openinfosecfoundation.org/issues/3174

5 years agoMake list-enabled-sources command as an option for list-sources
Vagisha Gupta [Fri, 10 Apr 2020 15:08:49 +0000 (20:38 +0530)] 
Make list-enabled-sources command as an option for list-sources

Removed `list-enabled-sources` command  and made use of single
command `suricata-update list-sources --enabled` to list all
the enabled sources.

Redmine issue:
        https://redmine.openinfosecfoundation.org/issues/3248

5 years agoShorten the state of being written for rule files
Shivani Bhardwaj [Tue, 6 Nov 2018 17:33:43 +0000 (23:03 +0530)] 
Shorten the state of being written for rule files

In an attempt to have shorter window for rule files of being written,
write the rules at first to `<filename>.tmp` and then rename the file.

Closes Redmine ticket #2327

5 years agoUse tempdir to log output with tests
Shivani Bhardwaj [Mon, 2 Mar 2020 03:56:54 +0000 (09:26 +0530)] 
Use tempdir to log output with tests

Closes redmine ticket 3262.

5 years agodoc: Add order of application of config files
Shivani Bhardwaj [Tue, 14 Apr 2020 07:45:17 +0000 (13:15 +0530)] 
doc: Add order of application of config files

Closes redmine ticket 3535.

5 years agomodify.conf: add more examples of usage
Shivani Bhardwaj [Fri, 26 Jun 2020 12:52:38 +0000 (18:22 +0530)] 
modify.conf: add more examples of usage

Closes redmine ticket 3550.