Skip to content

Commit dc72aba

Browse files
authored
Merge pull request #19 from crobinso/remove-sm
Remove --sm-* option references
2 parents 13bcff3 + 7bad703 commit dc72aba

File tree

4 files changed

+47
-49
lines changed

4 files changed

+47
-49
lines changed

builder/virt-builder.pod

Lines changed: 26 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -878,53 +878,6 @@ F<C:\Program Files\Guestfs\Firstboot\log.txt>.
878878

879879
=back
880880

881-
=head2 SUBSCRIPTION-MANAGER
882-
883-
It is possible to automate the registration and attaching of the
884-
system using C<subscription-manager>. This is typical on
885-
Red Hat Enterprise Linux guests. There are few options which ease
886-
this process, avoid executing commands manually and exposing
887-
passwords on command line.
888-
889-
I<--sm-register> starts the registration process, and requires
890-
I<--sm-credentials> to be specified; the format of the C<SELECTOR>
891-
of I<--sm-credentials> is one of the following formats:
892-
893-
=over 4
894-
895-
=item B<--sm-credentials> USER:file:FILENAME
896-
897-
Read the password for the specified C<USER> from F<FILENAME>.
898-
899-
=item B<--sm-credentials> USER:password:PASSWORD
900-
901-
Use the literal string C<PASSWORD> for the specified C<USER>.
902-
903-
=back
904-
905-
I<--sm-attach> attaches the system to subscriptions; the format
906-
of its C<SELECTOR> is one of the following:
907-
908-
=over 4
909-
910-
=item B<--sm-attach> auto
911-
912-
C<subscription-manager> attaches to the best-fitting subscriptions
913-
for the system.
914-
915-
=item B<--sm-attach> file:FILENAME
916-
917-
Read the pool ID from F<FILENAME>.
918-
919-
=item B<--sm-attach> pool:POOL
920-
921-
Use the literal string C<POOL> as pool ID.
922-
923-
=back
924-
925-
I<--sm-remove> removes all the subscriptions from the guest, while
926-
I<--sm-unregister> completely unregister the system.
927-
928881
=head2 INSTALLATION PROCESS
929882

930883
When you invoke virt-builder, installation proceeds as follows:
@@ -1764,6 +1717,32 @@ them, which is normal and harmless.
17641717

17651718
=back
17661719

1720+
=head2 DEPRECATED OPTIONS
1721+
1722+
In version 1.56 the subscription-manager options were removed.
1723+
1724+
=over 4
1725+
1726+
=item B<--sm-credentials>
1727+
1728+
=item B<--sm-register>
1729+
1730+
Use --run='subscription-manager register --username=USER --password=PASS'
1731+
1732+
=item B<--sm-unregister>
1733+
1734+
Use --run='subscription-manager unregister'
1735+
1736+
=item B<--sm-attach>
1737+
1738+
Use --run='subscription-manager attach ...'
1739+
1740+
=item B<--sm-remove>
1741+
1742+
Use --run='subscription-manager remove --all'
1743+
1744+
=back
1745+
17671746
=head1 MACHINE READABLE OUTPUT
17681747

17691748
The I<--machine-readable> option can be used to make the output more

customize/virt-customize.pod

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -248,6 +248,14 @@ existing ones.
248248

249249
For further details, see L<virt-builder(1)/SELINUX>.
250250

251+
=head1 DEPRECATED OPTIONS
252+
253+
In version 1.56 the subscription-manager options were removed:
254+
B<--sm-credentials>, B<--sm-register>, B<--sm-unregister>,
255+
B<--sm-attach>, B<--sm-remove>
256+
257+
For further details, see L<virt-builder(1)/DEPRECATED OPTIONS>.
258+
251259
=head1 EXIT STATUS
252260

253261
This program returns 0 on success, or 1 if there was an error.

podcheck.pl

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -203,7 +203,18 @@ =head1 OPTIONS
203203

204204
my %pod_options = ();
205205
$pod_options{$_} = 1 foreach ( $content =~ /^=item.*B<(-[-\w]+)(?:=.*)?>/gm );
206-
foreach (sort keys %pod_options) {
206+
207+
my %pod_option_exists = ();
208+
$pod_option_exists{$_} = 1 foreach keys %pod_options;
209+
210+
# Removed from the tool but we still document them
211+
delete $pod_option_exists{"--sm-credentials"};
212+
delete $pod_option_exists{"--sm-register"};
213+
delete $pod_option_exists{"--sm-unregister"};
214+
delete $pod_option_exists{"--sm-remove"};
215+
delete $pod_option_exists{"--sm-attach"};
216+
217+
foreach (sort keys %pod_option_exists) {
207218
unless ($ignore{$_}) {
208219
$pod_options_checked++;
209220
unless (exists $tool_option_exists{$_}) {

0 commit comments

Comments
 (0)