Skip to content

Commit

Permalink
docs: deprecate attach/auto-attach in man page
Browse files Browse the repository at this point in the history
Updated man-page to include deprecation notices
to usage instructions of 'attach' and 'auto-attach'
commands.

Signed-off-by: Jason Jerome <[email protected]>
  • Loading branch information
DuckBoss committed Jun 7, 2024
1 parent ccf0207 commit 2a097ba
Showing 1 changed file with 15 additions and 12 deletions.
27 changes: 15 additions & 12 deletions man/subscription-manager.8
Original file line number Diff line number Diff line change
Expand Up @@ -76,12 +76,6 @@ must be passed as system arguments in a non-interactive session.
.IP
2. unregister

.IP
3. attach

.IP
4. auto-attach

.IP
5. remove

Expand Down Expand Up @@ -138,7 +132,7 @@ must be passed as system arguments in a non-interactive session.

.RE

Following commands were deprecated: addons, role, service-level, subscribe, unsubscribe, usage, and activate
Following commands were deprecated: addons, attach, auto-attach, role, service-level, subscribe, unsubscribe, usage, and activate

.SS COMMON OPTIONS
.TP
Expand Down Expand Up @@ -259,8 +253,7 @@ subscription-manager register --org="IT Dept" --activationkey=1234abcd

.TP
.B --auto-attach
Automatically attaches compatible subscriptions to this system.

Deprecated, this option will be removed in future major releases. Automatically attaches compatible subscriptions to this system.

.TP
.B --servicelevel=LEVEL
Expand Down Expand Up @@ -301,7 +294,7 @@ command does two important things. Firstly, it will implicitly remove all of the
This command has no options.

.SS ATTACH OPTIONS
The
This command is \fBdeprecated\fP and will be removed from the future major releases. The
.B attach
command applies a specific subscription to the system. This command is not possible to use, when the content access mode of the organization to which the system is registered is simple content access mode.

Expand Down Expand Up @@ -338,7 +331,7 @@ or
.B --file.

.SS AUTO-ATTACH OPTIONS
The
This command is \fBdeprecated\fP and will be removed from the future major releases. The
.B auto-attach
command sets whether the ability to check, attach, and update subscriptions occurs automatically on the system. Auto-attaching subscriptions checks the currently-installed products, attached subscriptions, and any changes in available subscriptions every four hours using the \fBrhsmcertd\fP daemon.

Expand Down Expand Up @@ -1027,7 +1020,7 @@ Overall Status: Insufficient
.SS DEPRECATED COMMANDS
As the structures of subscription configuration have changed, some of the original management commands have become obsolete. These commands have been replaced with updated commands.

.TP
.TPs
.B subscribe
This has been replaced with attach. A similar registration option, \fB--subscribe\fP, has also be replaced with \fB--auto-attach\fP.

Expand All @@ -1043,6 +1036,14 @@ This has been replaced with \fBredeem\fP.
.B addons
This has been replaced with \fBsyspurpose addons\fP.

.TPs
.B attach
This option is not used for systems registered using \fBsimple content access\fP.

.TP
.B auto-attach
This option is not used for systems registered using \fBsimple content access\fP.

.TP
.B role
This has been replaced with \fBsyspurpose role\fP.
Expand Down Expand Up @@ -1171,6 +1172,8 @@ An option with registration,
.B --auto-attach,
will automatically attach the subscriptions pool which best matches the system architecture and configuration to the newly-registered system. This option attaches subscriptions as part of the registration process, rather than separately managing subscriptions.

This option is deprecated and will be removed in future major releases. This option should only be used with systems that are not registered using simple content access.

.RS
.nf
subscription-manager register --username=admin --password=secret
Expand Down

0 comments on commit 2a097ba

Please sign in to comment.