6964830 Remove the pcitool(1M) man page from the ON package

3 files changed, 3 insertions, 243 deletions

diff --git a/usr/src/cmd/pcitool/Makefile.com b/usr/src/cmd/pcitool/Makefile.com
index 937dce3950..6ed6c1fbf8 100644
--- a/usr/src/cmd/pcitool/Makefile.com
+++ b/usr/src/cmd/pcitool/Makefile.com
@@ -17,21 +17,13 @@
 #
 # CDDL HEADER END
 #
-# Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
-# Use is subject to license terms.
+# Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved.
 #
 
 PROG = pcitool
 OBJS = pcitool.o pcitool_ui.o pcitool_usage.o
 SRCS = $(OBJS:%.o=../%.c)
 
-#
-# Manpage is in the directory above platform-specific directory
-# from which this makefile is called.
-#
-MAN1MFILES = pcitool.1m
-MANFILE_SRC_PATH = ../$(MAN1MFILES)
-
 include $(SRC)/cmd/Makefile.cmd
 
 UTSBASE = ../../../../src/uts
@@ -44,7 +36,7 @@ LINTFLAGS += -I$(UTSBASE)/common
 
 .KEEP_STATE:
 
-all: $(PROG) $(MANFILE_SRC_PATH)
+all: $(PROG)
 
 $(SUBDIRS):	FRC
 	@cd $@; pwd; $(MAKE) $(TARGET)
@@ -53,13 +45,7 @@ $(PROG):	$(OBJS)
 	$(LINK.c) $(OBJS) -o $@ $(LDLIBS)
 	$(POST_PROCESS)
 
-$(ROOTMAN1M):
-	mkdir -p $(ROOTMAN1M)
-
-$(ROOTMAN1MFILES): $(MANFILE_SRC_PATH) $(ROOTMAN1M)
-	$(INS.file) $(MANFILE_SRC_PATH)
-
-install: all $(PROG) $(MANFILE_SRC_PATH)
+install: all $(PROG)
 
 clean:
 	$(RM) $(OBJS) $(PROG)
diff --git a/usr/src/cmd/pcitool/pcitool.1m b/usr/src/cmd/pcitool/pcitool.1m
deleted file mode 100644
index 461d0df8e4..0000000000
--- a/usr/src/cmd/pcitool/pcitool.1m
+++ /dev/null
@@ -1,222 +0,0 @@
-.\" CDDL HEADER START
-.\"
-.\" The contents of this file are subject to the terms of the
-.\" Common Development and Distribution License (the "License").
-.\" You may not use this file except in compliance with the License.
-.\"
-.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
-.\" or http://www.opensolaris.org/os/licensing.
-.\" See the License for the specific language governing permissions
-.\" and limitations under the License.
-.\"
-.\" When distributing Covered Code, include this CDDL HEADER in each
-.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
-.\" If applicable, add the following below this CDDL HEADER, with the
-.\" fields enclosed by brackets "[]" replaced with your own identifying
-.\" information: Portions Copyright [yyyy] [name of copyright owner]
-.\"
-.\" CDDL HEADER END
-.\"
-.\" Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
-.\"
-.TH pcitool 1M
-.SH "NAME"
-pcitool \- interrupt routing tool
-.SH "SYNOPSIS"
-.PP
-/usr/sbin/pcitool \fIpci@<unit-address>\fR|\f I niu@<unit-address>\fR -i \fI<[cpu#],ino#> | all\fR [ -r [ -c ] | -w \fI<cpu#>\fR [ -g ] ] [ -v ] [ -q ]
-
-/usr/sbin/pcitool \fIpci@<unit-address>\fR -m \fI<[cpu#],msi#> | all\fR [ -r [ -c ] | -w \fI<cpu#>\fR [ -g ] ] [ -v ] [ -q ]
-
-/usr/sbin/pcitool [ -h ]
-
-.SH "DESCRIPTION"
-.PP
-PCItool is a low-level tool which provides a facility for getting and setting
-interrupt routing information.
-
-.SS \fIInterrupt Routing\fR
-
-The \fIpcitool -i\fR command displays device and CPU routing information for
-INOs on a given nexus, and allows rerouting of a given INO or INO group to a
-specific CPU. Use the \fIpcitool -m\fR command to retrieve and reroute MSI/Xs.
-  
-On SPARC platforms, the INO is mapped to an interrupt mondo, where as one or
-more MSI/Xs are mapped to an INO. So, INO and MSI/Xs are individually
-retargetable. Use "-i" option to retrieve or reroute a given INO, where as
-use "-m" option for MSI/Xs.  
-   
-On x86 platforms, both INOs and MSI/Xs are mapped to the same interrupt vectors.
-Use "-i" option to retrieve and reroute any interrupt vectors (both INO and
-MSI/Xs).  So, "-m" option is not required on x86 platforms. Hence it is not
-supported.
-
-[cpu#] is available on x86 platform, is to identify exclusive vector with ino#
-at the same time. [cpu#] is not supported on SPARC platform.
-
-\fIRequired privileges\fR
-
-The user must have all privileges in order to access interrupt
-information.  A regular user can access interrupt information when
-\fBsu\fR(1M) to root or granted the "Maintenance and Repair" rights
-profile in the \fBuser_attr\fR file. See \fBuser_attr\fR(4) and
-\fBrbac\fR(5).
-
-
-\fICommandline options\fR
-
--r [ -c ]
-
-Display device and CPU routing information for INOs on a given nexus.
-The device path and instance number of each device for each displayed INO will
-be shown.  On some platforms, interrupts dedicated to the root complex are
-indicated with "(Internal)" appended to their pathname.
-
-Dump interrupt controller information with -c.
-
-If neither -r nor -w are provided on the commandline, -r is assumed.
-
-The command for showing all INOs on /pci@0,0 is:
-   
-  # pcitool /pci@0,0 -i all
-
-The command for showing ino <0x0,0x21> on  the  same  root  nexus, along with sample
-output, is:
-
-On x86 platform:
-  # pcitool /pci@0,0 -i 0,21 
-  0x0,0x21: mpt       0    /pci@7b,0/pci1022,7458@11/pci1000,3060@2
-
-On SPARC platform:
-  # pcitool /pci@0,0 -i 21 
-  0x0,0x21: mpt       0    /pci@7b,0/pci1022,7458@11/pci1000,3060@2
-   
-The command for showing MSI 0x1  on  the  same  root  nexus,
-along with sample output, is:
-   
-  # pcitool /pci@0,0 -m 0x1 
-  0x0,0x1: pcieb     0    /pci@7b,0/pci10de,5d@e
-
--w \fI<cpu#>\fR [ -g ]
-
-Route the given INO or MSI/X to the given CPU. Display the  new and original
-routing information. The INO or MSI/X must be specified.
-  
-Successful rerouting ino 21 above from cpu 0 to cpu 1 gives the following
-output:
-   
-On x86 platform:
-  # pcitool /pci@0,0 -i 0,21 -w 1
-  0x0,0x21 -> 0x1,0x20
- 
-On SPARC platform:
-  # pcitool /pci@0,0 -i 21 -w 1
-  0x0,0x21 -> 0x1,0x21
-
-Successful rerouting msi 1 above from cpu 1 to cpu 0 gives the following
-output:
-  
-  # pcitool /pci@0,0 -m 1 -w 0
-  0x1,0x1 -> 0x0,0x1
-
-On some platforms (such as X86) multiple MSI interrupts of a single function
-need to be rerouted together.  Use -g to do this.  -g works only on supported
-platforms  and only for groups of MSI interrupts.  (A "group" of 1 is accepted.)
-When -g is used, the vector provided must be the lowest-numbered vector of the
-group.  The size of the group is determined internally.
-
-Successful rerouting a group of INOs starting at 24 from cpu 0 to cpu 1 gives
-the following output:
-
-On x86 platform:
-  # pcitool /pci@0,0 -i 3,24 -w 1 -g
-  0x3,0x24 => 0x1,0x22
-
-On SPARC platform:
-  # pcitool /pci@0,0 -i 24 -w 1 -g
-  0x3,0x24 => 0x1,0x22
-
--v
-
-Verbose output.
-
--q
-
-No errors reported as messages.  Unix error status still returned by
-program, however.
-
-.SH EXIT STATUS
-
-The following error statuses are returned to the shell:
-
-.sp
-.ne 2
-.mk
-\fB0\fR
-.in +24n
-.rt
-No error
-.sp
-.sp 1
-.in -24n
-.sp
-.ne 2
-.mk
-\fBEINVAL\fR
-.in +24n
-.rt
-Out-of-range, misaligned or otherwise invalid argument has been passed in\&.
-.sp
-.sp 1
-.in -24n
-.sp
-.ne 2
-.mk
-\fBETIME\fR
-.in +24n
-.rt
-Timeout waiting for pending interrupt to settle before changing interrupts to
-a new CPU\&.
-.sp
-.sp 1
-.in -24n
-.sp
-.ne 2
-.mk
-\fBEIO\fR
-.in +24n
-.rt
-An IO error occurred\&.
-.sp
-.sp 1
-.in -24n
-
-.SH FILES
-  /usr/sbin/pcitool
-
-.SH "ATTRIBUTES"
-.PP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-  _________________________________________________________ 
- | ATTRIBUTE TYPE       | ATTRIBUTE VALUE                  |
- |______________________|__________________________________|
- | Architecture         | PCI-based systems                |
- |______________________|__________________________________|
- | Availability         | SUNWio-tools                     |
- |______________________|__________________________________|
- | Interface Stability  | Volatile                         |
- |______________________|__________________________________|
-
-.SH SEE ALSO
-\fBpci\fR(4), \fBsu\fR(1M), \fBuser_attr\fR(4), \fBrbac\fR(5)
-
-.SH NOTES
-All values are entered in hex.
-
-Not all commands are applicable to all platforms.
-
-REFERENCES
-
-PCI specification (available from www.pcisig.org)
diff --git a/usr/src/pkg/manifests/system-management-pcitool.mf b/usr/src/pkg/manifests/system-management-pcitool.mf
index 5c7a1d0e62..271750fece 100644
--- a/usr/src/pkg/manifests/system-management-pcitool.mf
+++ b/usr/src/pkg/manifests/system-management-pcitool.mf
@@ -39,11 +39,7 @@ set name=info.classification \
 set name=variant.arch value=$(ARCH)
 dir path=usr group=sys
 dir path=usr/sbin
-dir path=usr/share group=sys
-dir path=usr/share/man
-dir path=usr/share/man/man1m
 file path=usr/sbin/pcitool mode=0555
-file path=usr/share/man/man1m/pcitool.1m group=root
 legacy pkg=SUNWio-tools arch=$(ARCH) category=system \
     desc="Administrative tools to modify the pci/pcie fabric" \
     hotline="Please contact your local service provider" \