SORT BY:

LIST ORDER
THREAD
AUTHOR
SUBJECT


SEARCH

IPS HOME


    [Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

    RE: iSCSI: v9 concordance - the correct URL



    Title: RE: iSCSI: v9 concordance - the correct URL

    Sorry, Julo and David. Thanks, Pat, you are right. Somehow I sent the email out, an erase and a keystroke before I finished.

    The URL is http://www.iready.org/iscsi/iscsi09concordanceV1.doc (careful with a double-clicking, it might be better to ftp this, it's 11MB)

    All: let me know if the Concordance is useful and how it might be improved to help compose the final draft.

    Aloha

    Mike Smith
    CTO
    iReady

    -----Original Message-----
    From: pat_thaler@agilent.com [mailto:pat_thaler@agilent.com]
    Sent: Tuesday, December 04, 2001 10:45 AM
    To: smithm007@hotmail.com; ips@ece.cmu.edu
    Cc: msmith@iready.com
    Subject: RE: iSCSI: v9 concordance


    Mike,

    It looks like the URL is missing a 0 and should be:
     http://www.iready.org/iscsi/iscsi09concordanceV1.doc

    Regards,
    Pat

    -----Original Message-----
    From: Michael Sebastian Smith (Hotmail) [mailto:smithm007@hotmail.com]
    Sent: Monday, December 03, 2001 6:53 PM
    To: ips@ece.cmu.edu
    Cc: msmith@iready.com
    Subject: iSCSI: v9 concordance


    iSCSI: v8 concordanceI placed the concordance of the iSCSI v9 Internet draft
    at http://www.iready.org/iscsi/iscsi9concordanceV1.doc

    Aloha

    Mike Smith
    CTO
    iReady

    ----- Original Message -----
    From: Michael Smith
    To: 'ips@ece.cmu.edu'
    Cc: Michael Smith
    Sent: Monday, October 08, 2001 5:36 PM
    Subject: iSCSI: v8 concordance


    There have been several comments recently on this reflector about the use of
    terms and definitions in the current iSCSI Internet draft.
    I have created a concordance for the iSCSI v8 Internet draft. You may
    download the concordance at
    http://www.iready.org/iscsi/iscsi8concordanceV5.doc
    This is a very large file (10MB).
    A concordance is like an amplified index. A concordance is an ordered list
    of the occurence of every single word, term, and character in the iSCSI v8
    spec together with it's context (the context being a certain number of words
    around each occurence).
    Why is this useful? Let's take an example from the iSCSI Internet draft
    concordance file. Take the term "barrier". It often occurs as the term
    "barrier list" in the current Internet draft. But how is this term used
    exactly? First, look up "barrier (exactly as I have shown it here) in the
    concordance and you will see the following:


    "BARRIER................................................................5
                                                              layer.  The
    "barrier list" described in the following sections is a
    7370

    "barrier list";
    7382
                                                                a) if the
    "barrier list" is empty or ExpCmdSN is less than
    7392
                                                                        a
    "barrier list" including the referenced LUN (or an ALL
    7420
                                                                a) if the
    "barrier list" is empty or ExpCmdSN is less than
    7428
    This means the characters "barrier appear five times (lines 7370, 7382,
    7392, 7420, 7428 as numbered from the .txt version). Each time the
    characters "barrier occur as "barrier list". Continue now to look up just
    the characters barrier in the concordance. You will find:
    BARRIER.................................................................5
                                                   Note: for clarity, the
    barrier list contains "items" and the
    7387
                                      the CmdSN of the oldest item in the
    barrier list then
    7393
                                                     b) remove the oldest
    barrier list item, and remove and
    7395
                                                   the oldest item in the
    barrier list then skip to step d;
    7429
                                                     b) remove the oldest
    barrier list item and evaluate all
    7430


    Thus barrier also occurs five times (lines 7387, 7393, 7395, 7429, 7430).
    So what?
    The concordance has told us:
    1. If the term "barrier list" is defined the first time that it is used. (It
    is, sort of.)
    2. If the term "barrier list" is used consistently each time.
    3. That the use of quotes around barrier list is inconsistent and therefore
    perhaps misleading.
    I hope that, from this small example, you may easily extrapolate to other
    uses of a concordance in reading, understanding, and editing the current
    iSCSI Internet draft. I have found this technique useful in the past.
    Aloha
    Mike Smith
    CTO
    iReady



Home

Last updated: Wed Dec 05 05:17:48 2001
7997 messages in chronological order