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
This commit is contained in:
Bart Van Assche
2019-03-02 20:06:25 +00:00
parent 08e532715d
commit 87d82bfa8f
9 changed files with 13 additions and 64 deletions

View File

@@ -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:

View File

@@ -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

View File

@@ -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

View File

@@ -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 */

View File

@@ -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;

View File

@@ -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

View File

@@ -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"

View File

@@ -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

View File

@@ -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: