salt 3006.15__tar.gz → 3006.16__tar.gz

salt-3006.16/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: salt
+Version: 3006.16
+Summary: Portable, distributed, remote execution and configuration management system
+Home-page: https://saltproject.io
+Author: Thomas S Hatch
+Author-email: thatch45@gmail.com
+License: Apache Software License 2.0
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Cython
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Topic :: System :: Clustering
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: >=3.6
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+License-File: NOTICE
+License-File: AUTHORS
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-python
+Dynamic: summary
+
+.. image:: https://img.shields.io/github/license/saltstack/salt
+   :alt: Salt Project License: Apache v2.0
+   :target: https://github.com/saltstack/salt/blob/master/LICENSE
+
+.. image:: https://img.shields.io/pypi/dm/salt?label=pypi%20downloads
+   :alt: PyPi Package Downloads
+   :target: https://pypi.org/project/salt
+
+.. image:: https://img.shields.io/badge/discord-SaltProject-blue.svg?logo=discord
+   :alt: Salt Project Discord Community
+   :target: https://discord.com/invite/J7b7EscrAs
+
+.. image:: https://img.shields.io/reddit/subreddit-subscribers/saltstack?style=social
+   :alt: Salt Project subreddit
+   :target: https://www.reddit.com/r/saltstack/
+
+.. image:: https://img.shields.io/twitter/follow/Salt_Project_OS?style=social&logo=twitter
+   :alt: Follow SaltStack on Twitter
+   :target: https://twitter.com/intent/follow?screen_name=Salt_Project_OS
+
+.. figure:: https://gitlab.com/saltstack/open/salt-branding-guide/-/raw/master/logos/SaltProject_altlogo_teal.png?inline=true
+   :scale: 80 %
+   :width: 1000px
+   :height: 356px
+   :align: center
+   :alt: Salt Project Logo
+
+* `Latest Salt Documentation`_
+* `Open an issue`_ (bug report, feature request, etc.)
+
+*Salt is the world's fastest, most intelligent and scalable automation*
+*engine.*
+
+About Salt
+==========
+Built on Python, Salt is an event-driven automation tool and framework to
+deploy, configure, and manage complex IT systems. Use Salt to automate common
+infrastructure administration tasks and ensure that all the components of your
+infrastructure are operating in a consistent desired state.
+
+Salt has many possible uses, including configuration management, which involves:
+
+* Managing operating system deployment and configuration.
+* Installing and configuring software applications and services.
+* Managing servers, virtual machines, containers, databases, web servers,
+  network devices, and more.
+* Ensuring consistent configuration and preventing configuration drift.
+
+Salt is ideal for configuration management because it is pluggable,
+customizable, and plays well with many existing technologies. Salt enables you
+to deploy and manage applications that use any tech stack running on nearly any
+`operating system <https://docs.saltproject.io/salt/install-guide/en/latest/topics/salt-supported-operating-systems.html>`_,
+including different types of network devices such as switches and routers from a
+variety of vendors.
+
+In addition to configuration management Salt can also:
+
+* Automate and orchestrate routine IT processes, such as common required tasks
+  for scheduled server downtimes or upgrading operating systems or applications.
+* Create self-aware, self-healing systems that can automatically respond to
+  outages, common administration problems, or other important events.
+
+
+About our sponsors
+==================
+
+Salt powers VMware by Broadcom's `Tanzu Salt`_
+(previously Aria Automation Config / vRealize Automation SaltStack Config / SaltStack Enterprise), and can be found
+under the hood of products from Juniper, Cisco, Cloudflare, Nutanix, SUSE, and
+Tieto, to name a few.
+
+The original sponsor of our community, SaltStack, was acquired by VMware in 2020.
+`VMware was later acquired by Broadcom in 2023 <https://investors.broadcom.com/news-releases/news-release-details/broadcom-completes-acquisition-vmware>`__.
+The Salt Project remains an open source ecosystem that Broadcom supports and
+contributes to. Broadcom ensures the code integrity and quality of the Salt
+modules by acting as the official sponsor and manager of the Salt project. Many
+of the core Salt Project contributors are also Broadcom employees. This team
+carefully reviews and enhances the Salt modules to ensure speed, quality, and
+security.
+
+Download and install Salt
+=========================
+Salt is tested and packaged to run on CentOS, Debian, RHEL, Ubuntu, MacOS,
+Windows, and more. Download Salt and get started now. See
+`supported operating systems <https://docs.saltproject.io/salt/install-guide/en/latest/topics/salt-supported-operating-systems.html>`_
+for more information.
+
+To download and install Salt, see:
+
+* `The Salt install guide <https://docs.saltproject.io/salt/install-guide/en/latest/index.html>`_
+    * `Salt Project Repository: Linux (RPM) <https://packages.broadcom.com/artifactory/saltproject-rpm>`__ - Where Salt ``rpm`` packages are officially stored and distributed.
+    * `Salt Project Repository: Linux (DEB) <https://packages.broadcom.com/artifactory/saltproject-deb>`__ - Where Salt ``deb`` packages are officially stored and distributed.
+    * `Salt Project Repository: GENERIC <https://packages.broadcom.com/artifactory/saltproject-generic>`__ - Where Salt Windows, macOS, etc. (non-rpm, non-deb) packages are officially stored and distributed.
+
+Technical support
+=================
+Report bugs or problems using Salt by opening an issue: `<https://github.com/saltstack/salt/issues>`_
+
+To join our community forum where you can exchange ideas, best practices,
+discuss technical support questions, and talk to project maintainers, join our
+Discord server: `Salt Project Community Discord`_
+
+
+
+Salt Project documentation
+==========================
+Installation instructions, tutorials, in-depth API and module documentation:
+
+* `The Salt install guide <https://docs.saltproject.io/salt/install-guide/en/latest/index.html>`_
+* `The Salt user guide <https://docs.saltproject.io/salt/user-guide/en/latest/>`_
+* `Latest Salt documentation`_
+* `Salt's contributing guide <https://docs.saltproject.io/en/master/topics/development/contributing.html>`_
+
+
+Security advisories
+===================
+Keep an eye on the Salt Project
+`Security Announcements <https://saltproject.io/security-announcements/>`_
+landing page. Salt Project recommends subscribing to the
+`Salt Project Security RSS feed <https://saltproject.io/security-announcements/index.xml>`_
+to receive notification when new information is available regarding security
+announcements.
+
+Other channels to receive security announcements include the
+`Salt Community mailing list <https://groups.google.com/forum/#!forum/salt-users>`_
+and the `Salt Project Community Discord`_.
+
+
+Responsibly reporting security vulnerabilities
+++++++++++++++++++++++++++++++++++++++++++++++
+When reporting security vulnerabilities for Salt or other SaltStack projects,
+refer to the `SECURITY.md`_ file found in this repository.
+
+
+Join our community
+==================
+Salt is built by the Salt Project community, which includes more than 3,000
+contributors working in roles just like yours. This well-known and trusted
+community works together to improve the underlying technology and extend Salt by
+creating a variety of execution and state modules to accomplish the most common
+tasks or solve the most important problems that people in your role are likely
+to face.
+
+If you want to help extend Salt or solve a problem with Salt, you can join our
+community and contribute today.
+
+Please be sure to review our
+`Code of Conduct <https://github.com/saltstack/salt/blob/master/CODE_OF_CONDUCT.md>`_.
+Also, check out some of our community resources including:
+
+* `Salt Project Community Discord`_
+* `Salt Project YouTube channel <https://www.youtube.com/channel/UCpveTIucFx9ljGelW63-BWg>`_
+* `Salt Project Community Notes and Wiki <https://github.com/saltstack/community/>`_
+
+There are lots of ways to get involved in our community. Every month, there are
+around a dozen opportunities to meet with other contributors and the Salt Core
+team and collaborate in real time. The best way to keep track is by subscribing
+to the **Salt Project Community Events Calendar** on the main
+`<https://saltproject.io>`_ website.
+
+If you have additional questions, email us at saltproject.pdl@broadcom.com or reach out
+directly to the Community Discord. We'd be glad to have you join our community!
+
+License
+=======
+Salt is licensed under the Apache 2.0 license. Please
+see the
+`LICENSE file <https://github.com/saltstack/salt/blob/master/LICENSE>`_ for the
+full text of the Apache license, followed by a full summary of the licensing
+used by external modules.
+
+A complete list of attributions and dependencies can be found here:
+`salt/DEPENDENCIES.md <https://github.com/saltstack/salt/blob/master/DEPENDENCIES.md>`_
+
+.. _Salt Project Community Discord: https://discord.com/invite/J7b7EscrAs
+.. _Tanzu Salt: https://www.vmware.com/products/app-platform/tanzu-salt
+.. _Latest Salt Documentation: https://docs.saltproject.io/en/latest/
+.. _Open an issue: https://github.com/saltstack/salt/issues/new/choose
+.. _SECURITY.md: https://github.com/saltstack/salt/blob/master/SECURITY.md

salt-3006.16/doc/man/salt-api.1

@@ -0,0 +1,114 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "SALT-API" "1" "Generated on September 17, 2025 at 21:45:25 UTC." "3006.16" "Salt"
+.SH NAME
+salt-api \- salt-api Command
+.sp
+Start interfaces used to remotely connect to the salt master
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+salt\-api
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+The Salt API system manages network api connectors for the Salt Master
+.SH OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-version
+Print the version of Salt that is running.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-versions\-report
+Show program\(aqs dependencies and version number, and then exit
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-h, \-\-help
+Show the help message and exit
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-c CONFIG_DIR, \-\-config\-dir=CONFIG_dir
+The location of the Salt configuration directory. This directory contains
+the configuration files for Salt master and minions. The default location
+on most systems is \fB/etc/salt\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-d, \-\-daemon
+Run the salt\-api as a daemon
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-pid\-file=PIDFILE
+Specify the location of the pidfile. Default: /var/run/salt\-api.pid
+.UNINDENT
+.SS Logging Options
+.sp
+Logging options which override any settings defined on the configuration files.
+.INDENT 0.0
+.TP
+.B \-l LOG_LEVEL, \-\-log\-level=LOG_LEVEL
+Console logging log level. One of \fBall\fP, \fBgarbage\fP, \fBtrace\fP,
+\fBdebug\fP, \fBinfo\fP, \fBwarning\fP, \fBerror\fP, \fBquiet\fP\&. Default:
+\fBwarning\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-log\-file=LOG_FILE
+Log file path. Default: /var/log/salt/api\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-log\-file\-level=LOG_LEVEL_LOGFILE
+Logfile logging log level. One of \fBall\fP, \fBgarbage\fP, \fBtrace\fP,
+\fBdebug\fP, \fBinfo\fP, \fBwarning\fP, \fBerror\fP, \fBquiet\fP\&. Default:
+\fBwarning\fP\&.
+.UNINDENT
+.SH SEE ALSO
+.sp
+\fBsalt\-api(7)\fP
+\fBsalt(7)\fP
+\fBsalt\-master(1)\fP
+.SH AUTHOR
+Thomas S. Hatch <thatch45@gmail.com> and many others, please see the Authors file
+.SH COPYRIGHT
+2025
+.\" Generated by docutils manpage writer.
+.

salt-3006.16/doc/man/salt-call.1

@@ -0,0 +1,267 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "SALT-CALL" "1" "Generated on September 17, 2025 at 21:45:25 UTC." "3006.16" "Salt"
+.SH NAME
+salt-call \- salt-call Documentation
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+salt\-call [options]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+The salt\-call command is used to run module functions locally on a minion
+instead of executing them from the master. Salt\-call is used to run a
+\fI\%Standalone Minion\fP, and was originally
+created for \fI\%troubleshooting\fP\&.
+.sp
+The Salt Master is contacted to retrieve state files and other resources
+during execution unless the \fB\-\-local\fP option is specified.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBsalt\-call\fP commands execute from the current user\(aqs shell
+context, while \fBsalt\fP commands execute from the system\(aqs default context.
+.UNINDENT
+.UNINDENT
+.SH OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-version
+Print the version of Salt that is running.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-versions\-report
+Show program\(aqs dependencies and version number, and then exit
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-h, \-\-help
+Show the help message and exit
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-c CONFIG_DIR, \-\-config\-dir=CONFIG_dir
+The location of the Salt configuration directory. This directory contains
+the configuration files for Salt master and minions. The default location
+on most systems is \fB/etc/salt\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-hard\-crash
+Raise any original exception rather than exiting gracefully Default: False
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-g, \-\-grains
+Return the information generated by the Salt grains
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-m MODULE_DIRS, \-\-module\-dirs=MODULE_DIRS
+Specify an additional directory to pull modules from.  Multiple directories
+can be provided by passing \-m /\-\-module\-dirs multiple times.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-d, \-\-doc, \-\-documentation
+Return the documentation for the specified module or for all modules if
+none are specified
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-master=MASTER
+Specify the master to use. The minion must be authenticated with the
+master. If this option is omitted, the master options from the minion
+config will be used. If multi masters are set up the first listed master
+that responds will be used.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-return RETURNER
+Set salt\-call to pass the return data to one or many returner interfaces.
+To use many returner interfaces specify a comma delimited list of
+returners.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-local
+Run salt\-call locally, as if there was no master running.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-file\-root=FILE_ROOT
+Set this directory as the base file root.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-pillar\-root=PILLAR_ROOT
+Set this directory as the base pillar root.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-retcode\-passthrough
+Exit with the salt call retcode and not the salt binary retcode
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-return\-event
+Do not send the return event back to master.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-metadata
+Print out the execution metadata as well as the return. This will print out
+the outputter data, the return code, etc.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-id=ID
+Specify the minion id to use. If this option is omitted, the id option from
+the minion config will be used.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-grains
+Do not load grains.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-refresh\-grains\-cache
+Force a refresh of the grains cache
+.UNINDENT
+.SS Logging Options
+.sp
+Logging options which override any settings defined on the configuration files.
+.INDENT 0.0
+.TP
+.B \-l LOG_LEVEL, \-\-log\-level=LOG_LEVEL
+Console logging log level. One of \fBall\fP, \fBgarbage\fP, \fBtrace\fP,
+\fBdebug\fP, \fBinfo\fP, \fBwarning\fP, \fBerror\fP, \fBquiet\fP\&. Default:
+\fBwarning\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-log\-file=LOG_FILE
+Log file path. Default: /var/log/salt/minion\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-log\-file\-level=LOG_LEVEL_LOGFILE
+Logfile logging log level. One of \fBall\fP, \fBgarbage\fP, \fBtrace\fP,
+\fBdebug\fP, \fBinfo\fP, \fBwarning\fP, \fBerror\fP, \fBquiet\fP\&. Default:
+\fBwarning\fP\&.
+.UNINDENT
+.SS Output Options
+.INDENT 0.0
+.TP
+.B \-\-out
+Pass in an alternative outputter to display the return of data. This
+outputter can be any of the available outputters:
+.INDENT 7.0
+.INDENT 3.5
+\fBhighstate\fP, \fBjson\fP, \fBkey\fP, \fBoverstatestage\fP, \fBpprint\fP, \fBraw\fP, \fBtxt\fP, \fByaml\fP, and \fI\%many others\fP\&.
+.UNINDENT
+.UNINDENT
+.sp
+Some outputters are formatted only for data returned from specific functions.
+If an outputter is used that does not support the data passed into it, then
+Salt will fall back on the \fBpprint\fP outputter and display the return data
+using the Python \fBpprint\fP standard library module.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-out\-indent OUTPUT_INDENT, \-\-output\-indent OUTPUT_INDENT
+Print the output indented by the provided value in spaces. Negative values
+disable indentation. Only applicable in outputters that support
+indentation.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-out\-file=OUTPUT_FILE, \-\-output\-file=OUTPUT_FILE
+Write the output to the specified file.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-out\-file\-append, \-\-output\-file\-append
+Append the output to the specified file.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-no\-color
+Disable all colored output
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-force\-color
+Force colored output
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+When using colored output the color codes are as follows:
+.sp
+\fBgreen\fP denotes success, \fBred\fP denotes failure, \fBblue\fP denotes
+changes and success and \fByellow\fP denotes a expected future change in configuration.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-state\-output=STATE_OUTPUT, \-\-state_output=STATE_OUTPUT
+Override the configured state_output value for minion
+output. One of \(aqfull\(aq, \(aqterse\(aq, \(aqmixed\(aq, \(aqchanges\(aq or
+\(aqfilter\(aq. Default: \(aqnone\(aq.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-state\-verbose=STATE_VERBOSE, \-\-state_verbose=STATE_VERBOSE
+Override the configured state_verbose value for minion
+output. Set to True or False. Default: none.
+.UNINDENT
+.SH SEE ALSO
+.sp
+\fBsalt(1)\fP
+\fBsalt\-master(1)\fP
+\fBsalt\-minion(1)\fP
+.SH AUTHOR
+Thomas S. Hatch <thatch45@gmail.com> and many others, please see the Authors file
+.SH COPYRIGHT
+2025
+.\" Generated by docutils manpage writer.
+.