From 87d82bfa8fb55f2add0708d726fa3e073ba92c1d Mon Sep 17 00:00:00 2001 From: Bart Van Assche Date: Sat, 2 Mar 2019 20:06:25 +0000 Subject: [PATCH] Remove documentation references to procfs Now that procfs has been removed, remove the references to procfs from the documentation. git-svn-id: http://svn.code.sf.net/p/scst/svn/trunk@8000 d57e44dd-8a1f-0410-8b47-8ef2f437770f --- iscsi-scst/README | 10 ++-------- qla2x00t/qla2x00-target/README | 4 +--- scst/README | 17 +++-------------- scst/include/scst.h | 2 +- scst_local/scst_local.c | 7 +------ scstadmin/README | 15 ++++----------- scstadmin/default/scst | 4 ---- scstadmin/scstadmin.sysfs/man5/scst.5 | 14 -------------- srpt/README | 4 +--- 9 files changed, 13 insertions(+), 64 deletions(-) diff --git a/iscsi-scst/README b/iscsi-scst/README index 01756e6e0..bdd0b9087 100644 --- a/iscsi-scst/README +++ b/iscsi-scst/README @@ -38,10 +38,7 @@ compiler complains about redefinition of some symbol, you should either switch to vanilla kernel, or add or change as necessary the corresponding to that symbol "#if LINUX_VERSION_CODE" statement. -Default sysfs interface supports only kernels 2.6.26 and higher, because -in 2.6.26 internal kernel's sysfs interface had a major change, which -made it heavily incompatible with pre-2.6.26 version. But with the -obsolete procfs interface kernels 2.6.16+ are supported. +Kernel versions 2.6.26 and higher are supported. If during compilation you see message like "*** No rule to make target `xxx.h', needed by `yyy.o'. Stop.", then your autogenerated @@ -162,12 +159,9 @@ ietd.conf files for us to play with). Sysfs interface --------------- -Starting from 2.0.0 iSCSI-SCST uses sysfs interface. The procfs -interface is obsolete and will be removed in one of the next versions. The sysfs build supports only kernels 2.6.26 and higher, because in 2.6.26 internal kernel's sysfs interface had a major change, which made -it heavily incompatible with pre-2.6.26 version. But with the obsolete -procfs interface kernels 2.6.16+ are supported. +it heavily incompatible with pre-2.6.26 version. Root of SCST sysfs interface is /sys/kernel/scst_tgt. Root of iSCSI-SCST is /sys/kernel/scst_tgt/targets/iscsi. It has the following entries: diff --git a/qla2x00t/qla2x00-target/README b/qla2x00t/qla2x00-target/README index 2235c849e..b6514da4d 100644 --- a/qla2x00t/qla2x00-target/README +++ b/qla2x00t/qla2x00-target/README @@ -244,9 +244,7 @@ in/out in Makefile: Sysfs interface --------------- -Starting from 2.0.0 this driver has sysfs interface. The procfs -interface from version 2.0.0 is obsolete and will be removed in one of -the next versions. +Starting from 2.0.0 this driver has sysfs interface. Root of SCST sysfs interface is /sys/kernel/scst_tgt. Root of this driver is /sys/kernel/scst_tgt/targets/qla2x00t. It has the following diff --git a/scst/README b/scst/README index 6e0a28477..b314601d0 100644 --- a/scst/README +++ b/scst/README @@ -57,10 +57,7 @@ your compiler complains about redefinition of some symbol, you should either switch to vanilla kernel, or add or change as necessary the corresponding to that symbol "#if LINUX_VERSION_CODE" statement. -Default sysfs interface supports only kernels 2.6.26 and higher, because -in 2.6.26 internal kernel's sysfs interface had a major change, which -made it heavily incompatible with pre-2.6.26 version. But with the -obsolete procfs interface kernels 2.6.16+ are supported. +Kernel version 2.6.26 and higher are supported. At first, make sure that the link "/lib/modules/`you_kernel_version`/build" points to the source code for your currently running kernel. @@ -413,8 +410,7 @@ SCST sysfs interface Starting from 2.0.0 SCST has sysfs interface. It supports only kernels 2.6.26 and higher, because in 2.6.26 internal kernel's sysfs interface had a major change, which made it heavily incompatible with pre-2.6.26 -version. If you need pre-2.6.26 kernel, you need to use obsolete procfs -interface (see below). +version. SCST sysfs interface designed to be self descriptive and self containing. This means that a high level management tool for it can be @@ -1101,9 +1097,7 @@ created, i.e. before the target enabled. VDISK device handler -------------------- -Starting from 2.0.0 VDISK device handler uses sysfs interface. The -procfs interface is obsolete and will be removed in one of the next -versions. +Starting from 2.0.0 VDISK device handler uses sysfs interface. VDISK has 4 built-in dev handlers: vdisk_fileio, vdisk_blockio, vdisk_nullio and vcdrom. Roots of their sysfs interface are @@ -1575,11 +1569,6 @@ failure to prevent Persistent Reservation information from corruption during update. It is safe to assume that each of those files can be up to 1KB big. -The "Persistence Through Power Loss" feature is not available in the -procfs build, because the SCST proc interface doesn't allow to keep -persistent Relative Target IDs of each target between reboots/reloads -(they are load and initialization order dependent). - The Persistent Reservations available on all transports implementing get_initiator_port_transport_id() callback. Transports not implementing this callback will act in one of 2 possible scenarios ("all or diff --git a/scst/include/scst.h b/scst/include/scst.h index c67c54eb3..0bc6d71de 100644 --- a/scst/include/scst.h +++ b/scst/include/scst.h @@ -3272,7 +3272,7 @@ struct scst_acg { /* List of attached acn's, protected by scst_mutex */ struct list_head acn_list; - /* List entry in acg_lists (procfs) or tgt_acg_list (sysfs) */ + /* List entry in tgt_acg_list */ struct list_head acg_list_entry; /* Name of this acg */ diff --git a/scst_local/scst_local.c b/scst_local/scst_local.c index 7dbaa2087..d37afe927 100644 --- a/scst_local/scst_local.c +++ b/scst_local/scst_local.c @@ -2036,12 +2036,7 @@ static int __init scst_local_init(void) goto tgt_templ_unreg; } - /* - * If we are using sysfs, then don't add a default target unless - * we are told to do so. When using procfs, we always add a default - * target because that was what the earliest versions did. Just - * remove the preprocessor directives when no longer needed. - */ + /* Don't add a default target unless we are told to do so. */ if (!scst_local_add_default_tgt) goto out; diff --git a/scstadmin/README b/scstadmin/README index da8337339..0abdf931f 100644 --- a/scstadmin/README +++ b/scstadmin/README @@ -8,15 +8,9 @@ The perl module SCST::SCST is very generic and tries to handle error checking as The init script was written for debian but should work on most distributions. - scstadmin.sysfs - Use this version if you've disabled procfs support in SCST. - scstadmin.procfs - This is the default version which uses the older procfs. - - scst-0.8.22 This is the SCST Perl module required by scstadmin and scst_db. - scst-0.9.00 This is the SCST Perl module to be used with SCST compiled - for sysfs. Note, the current version of scstadmin will NOT yet - work with this module. + scstadmin.sysfs scstadmin version that supports sysfs. + scst-1.0.0 This is the SCST Perl module to be used with SCST compiled + for sysfs. scstadmin Script which can accept operations on a command line or from a configuration file. See scst.conf. For command help, @@ -50,8 +44,7 @@ exists. GETTING HELP ------------ -The new scstadmin has many more options than the olde procfs version to see -them, type: +To see the scstadmin command line options, type: scstadmin --help diff --git a/scstadmin/default/scst b/scstadmin/default/scst index 09a86dbcd..6d90290f2 100644 --- a/scstadmin/default/scst +++ b/scstadmin/default/scst @@ -1,6 +1,2 @@ # iscsi-scstd command-line options. See also man iscsi-scstd. # ISCSID_OPTIONS="-u0 -g0 -p3260" - -# When using the procfs interface, specify all SCST target drivers in -# SCST_TARGET_MODULES. An example: -# SCST_TARGET_MODULES="scst_local iscsi_scst ib_srpt" diff --git a/scstadmin/scstadmin.sysfs/man5/scst.5 b/scstadmin/scstadmin.sysfs/man5/scst.5 index a23ea8f23..2e8175228 100644 --- a/scstadmin/scstadmin.sysfs/man5/scst.5 +++ b/scstadmin/scstadmin.sysfs/man5/scst.5 @@ -15,12 +15,6 @@ Specifies which command-line options will be passed to iscsi-scstd by the SCST init script when SCST is started. This variable is ignored if no iSCSI target entries have been defined in /etc/scst.conf. See also the iscsi-scstd man page for more information about the supported command-line options. -.TP -.B SCST_TARGET_MODULES -This variable has only to be set when the procfs interface of SCST is being -used instead of the sysfs interface. It defines which target modules should be -loaded by the SCST init script when SCST is started and also which target -modules should be unloaded when SCST is stopped. .P The format of the /etc/default/scst file is as follows: .br @@ -38,14 +32,6 @@ An example: ISCSID_OPTIONS="-u0 -g0 -p3260" .br -.br -# When using the procfs interface, the /etc/init.d/scst script -.br -# cannot derive from /etc/scst.conf which target modules will -.br -# be used and hence these have to be specified explicitly. -.br -SCST_TARGET_MODULES="scst_local iscsi_scst ib_srpt" .SH FILES .IP /etc/default/scst Configuration file that controls the behavior of some aspects of diff --git a/srpt/README b/srpt/README index 3e590bd09..9c6fe1f66 100644 --- a/srpt/README +++ b/srpt/README @@ -99,9 +99,7 @@ the scstadmin tool as follows: Now configure SCST using scstadmin - see also the scstadmin documentation for further information. Once finished, save the configuration to /etc/scst.conf: - scstadmin -write_config /etc/scst.conf (sysfs version) -or - scstadmin -WriteConfig /etc/scst.conf (procfs version) + scstadmin -write_config /etc/scst.conf One can verify the contents of scst.conf e.g. as follows: