From bf7fda8965eb0f1d22b8e7bf1684b99227cd2b64 Mon Sep 17 00:00:00 2001 From: Jimmy Vetayases Date: Thu, 1 Jul 2010 13:48:34 -0700 Subject: 6964830 Remove the pcitool(1M) man page from the ON package --- usr/src/cmd/pcitool/Makefile.com | 20 +- usr/src/cmd/pcitool/pcitool.1m | 222 --------------------- usr/src/pkg/manifests/system-management-pcitool.mf | 4 - 3 files changed, 3 insertions(+), 243 deletions(-) delete mode 100644 usr/src/cmd/pcitool/pcitool.1m (limited to 'usr/src') 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@\fR|\f I niu@\fR -i \fI<[cpu#],ino#> | all\fR [ -r [ -c ] | -w \fI\fR [ -g ] ] [ -v ] [ -q ] - -/usr/sbin/pcitool \fIpci@\fR -m \fI<[cpu#],msi#> | all\fR [ -r [ -c ] | -w \fI\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\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" \ -- cgit v1.2.3