URL https://opencores.org/ocsvn/or1k/or1k/trunk
Subversion Repositories or1k

[/] [or1k/] [tags/] [LINUX_2_4_26_OR32/] [linux/] [linux-2.4/] [fs/] [reiserfs/] [namei.c] - Blame information for rev 1765

Details | Compare with Previous | View Log

/*
 * Copyright 2000-2002 by Hans Reiser, licensing governed by reiserfs/README
 */
 
#include <linux/config.h>
#include <linux/sched.h>
#include <linux/bitops.h>
#include <linux/reiserfs_fs.h>
#include <linux/smp_lock.h>
 
#define INC_DIR_INODE_NLINK(i) if (i->i_nlink != 1) { i->i_nlink++; if (i->i_nlink >= REISERFS_LINK_MAX) i->i_nlink=1; }
#define DEC_DIR_INODE_NLINK(i) if (i->i_nlink != 1) i->i_nlink--;
 
// directory item contains array of entry headers. This performs
// binary search through that array
static int bin_search_in_dir_item (struct reiserfs_dir_entry * de, loff_t off)
{
    struct item_head * ih = de->de_ih;
    struct reiserfs_de_head * deh = de->de_deh;
    int rbound, lbound, j;
 
    lbound = 0;
    rbound = I_ENTRY_COUNT (ih) - 1;
 
    for (j = (rbound + lbound) / 2; lbound <= rbound; j = (rbound + lbound) / 2) {
        if (off < deh_offset (deh + j)) {
            rbound = j - 1;
            continue;
        }
        if (off > deh_offset (deh + j)) {
            lbound = j + 1;
            continue;
        }
        // this is not name found, but matched third key component
        de->de_entry_num = j;
        return NAME_FOUND;
    }
 
    de->de_entry_num = lbound;
    return NAME_NOT_FOUND;
}
 
 
// comment?  maybe something like set de to point to what the path points to?
static inline void set_de_item_location (struct reiserfs_dir_entry * de, struct path * path)
{
    de->de_bh = get_last_bh (path);
    de->de_ih = get_ih (path);
    de->de_deh = B_I_DEH (de->de_bh, de->de_ih);
    de->de_item_num = PATH_LAST_POSITION (path);
}
 
 
// de_bh, de_ih, de_deh (points to first element of array), de_item_num is set
inline void set_de_name_and_namelen (struct reiserfs_dir_entry * de)
{
    struct reiserfs_de_head * deh = de->de_deh + de->de_entry_num;
 
    if (de->de_entry_num >= ih_entry_count (de->de_ih))
        BUG ();
 
    de->de_entrylen = entry_length (de->de_bh, de->de_ih, de->de_entry_num);
    de->de_namelen = de->de_entrylen - (de_with_sd (deh) ? SD_SIZE : 0);
    de->de_name = B_I_PITEM (de->de_bh, de->de_ih) + deh_location(deh);
    if (de->de_name[de->de_namelen - 1] == 0)
        de->de_namelen = strlen (de->de_name);
}
 
 
// what entry points to
static inline void set_de_object_key (struct reiserfs_dir_entry * de)
{
    if (de->de_entry_num >= ih_entry_count (de->de_ih))
        BUG ();
    de->de_dir_id = deh_dir_id( &(de->de_deh[de->de_entry_num]));
    de->de_objectid = deh_objectid( &(de->de_deh[de->de_entry_num]));
}
 
 
static inline void store_de_entry_key (struct reiserfs_dir_entry * de)
{
    struct reiserfs_de_head * deh = de->de_deh + de->de_entry_num;
 
    if (de->de_entry_num >= ih_entry_count (de->de_ih))
        BUG ();
 
    /* store key of the found entry */
    de->de_entry_key.version = KEY_FORMAT_3_5;
    de->de_entry_key.on_disk_key.k_dir_id = le32_to_cpu (de->de_ih->ih_key.k_dir_id);
    de->de_entry_key.on_disk_key.k_objectid = le32_to_cpu (de->de_ih->ih_key.k_objectid);
    set_cpu_key_k_offset (&(de->de_entry_key), deh_offset (deh));
    set_cpu_key_k_type (&(de->de_entry_key), TYPE_DIRENTRY);
}
 
 
/* We assign a key to each directory item, and place multiple entries
in a single directory item.  A directory item has a key equal to the
key of the first directory entry in it.
 
This function first calls search_by_key, then, if item whose first
entry matches is not found it looks for the entry inside directory
item found by search_by_key. Fills the path to the entry, and to the
entry position in the item
 
*/
 
/* The function is NOT SCHEDULE-SAFE! */
int search_by_entry_key (struct super_block * sb, const struct cpu_key * key,
                         struct path * path, struct reiserfs_dir_entry * de)
{
    int retval;
 
    retval = search_item (sb, key, path);
    switch (retval) {
    case ITEM_NOT_FOUND:
        if (!PATH_LAST_POSITION (path)) {
            reiserfs_warning (sb, "vs-7000: search_by_entry_key: search_by_key returned item position == 0\n");
            pathrelse(path) ;
            return IO_ERROR ;
        }
        PATH_LAST_POSITION (path) --;
 
    case ITEM_FOUND:
        break;
 
    case IO_ERROR:
        return retval;
 
    default:
        pathrelse (path);
        reiserfs_warning (sb, "vs-7002: search_by_entry_key: no path to here\n ");
        return IO_ERROR;
    }
 
    set_de_item_location (de, path);
 
#ifdef CONFIG_REISERFS_CHECK
    if (!is_direntry_le_ih (de->de_ih) ||
        COMP_SHORT_KEYS (&(de->de_ih->ih_key), key)) {
        print_block (de->de_bh, 0, -1, -1);
        reiserfs_panic (sb, "vs-7005: search_by_entry_key: found item %h is not directory item or "
                        "does not belong to the same directory as key %K", de->de_ih, key);
    }
#endif /* CONFIG_REISERFS_CHECK */
 
    /* binary search in directory item by third componen t of the
       key. sets de->de_entry_num of de */
    retval = bin_search_in_dir_item (de, cpu_key_k_offset (key));
    path->pos_in_item = de->de_entry_num;
    if (retval != NAME_NOT_FOUND) {
        // ugly, but rename needs de_bh, de_deh, de_name, de_namelen, de_objectid set
        set_de_name_and_namelen (de);
        set_de_object_key (de);
    }
    return retval;
}
 
 
 
/* Keyed 32-bit hash function using TEA in a Davis-Meyer function */
 
/* The third component is hashed, and you can choose from more than
   one hash function.  Per directory hashes are not yet implemented
   but are thought about. This function should be moved to hashes.c
   Jedi, please do so.  -Hans */
 
static __u32 get_third_component (struct super_block * s,
                                  const char * name, int len)
{
    __u32 res;
 
    if (!len || (len == 1 && name[0] == '.'))
        return DOT_OFFSET;
    if (len == 2 && name[0] == '.' && name[1] == '.')
        return DOT_DOT_OFFSET;
 
    res = s->u.reiserfs_sb.s_hash_function (name, len);
 
    // take bits from 7-th to 30-th including both bounds
    res = GET_HASH_VALUE(res);
    if (res == 0)
        // needed to have no names before "." and ".." those have hash
        // value == 0 and generation conters 1 and 2 accordingly
        res = 128;
    return res + MAX_GENERATION_NUMBER;
}
 
 
static int reiserfs_match (struct reiserfs_dir_entry * de,
                           const char * name, int namelen)
{
    int retval = NAME_NOT_FOUND;
 
    if ((namelen == de->de_namelen) &&
        !memcmp(de->de_name, name, de->de_namelen))
        retval = (de_visible (de->de_deh + de->de_entry_num) ? NAME_FOUND : NAME_FOUND_INVISIBLE);
 
    return retval;
}
 
 
/* de's de_bh, de_ih, de_deh, de_item_num, de_entry_num are set already */
 
                                /* used when hash collisions exist */
 
 
static int linear_search_in_dir_item (struct cpu_key * key, struct reiserfs_dir_entry * de,
                                      const char * name, int namelen)
{
    struct reiserfs_de_head * deh = de->de_deh;
    int retval;
    int i;
 
    i = de->de_entry_num;
 
    if (i == I_ENTRY_COUNT (de->de_ih) ||
        GET_HASH_VALUE (deh_offset (deh + i)) != GET_HASH_VALUE (cpu_key_k_offset (key))) {
        i --;
    }
 
    RFALSE( de->de_deh != B_I_DEH (de->de_bh, de->de_ih),
            "vs-7010: array of entry headers not found");
 
    deh += i;
 
    for (; i >= 0; i --, deh --) {
        if (GET_HASH_VALUE (deh_offset (deh)) !=
            GET_HASH_VALUE (cpu_key_k_offset (key))) {
            // hash value does not match, no need to check whole name
            return NAME_NOT_FOUND;
        }
 
        /* mark, that this generation number is used */
        if (de->de_gen_number_bit_string)
            set_bit (GET_GENERATION_NUMBER (deh_offset (deh)), (unsigned long *)de->de_gen_number_bit_string);
 
        // calculate pointer to name and namelen
        de->de_entry_num = i;
        set_de_name_and_namelen (de);
 
        if ((retval = reiserfs_match (de, name, namelen)) != NAME_NOT_FOUND) {
            // de's de_name, de_namelen, de_recordlen are set. Fill the rest:
 
            // key of pointed object
            set_de_object_key (de);
 
            store_de_entry_key (de);
 
            // retval can be NAME_FOUND or NAME_FOUND_INVISIBLE
            return retval;
        }
    }
 
    if (GET_GENERATION_NUMBER (le_ih_k_offset (de->de_ih)) == 0)
        /* we have reached left most entry in the node. In common we
           have to go to the left neighbor, but if generation counter
           is 0 already, we know for sure, that there is no name with
           the same hash value */
        // FIXME: this work correctly only because hash value can not
        // be 0. Btw, in case of Yura's hash it is probably possible,
        // so, this is a bug
        return NAME_NOT_FOUND;
 
    RFALSE( de->de_item_num,
            "vs-7015: two diritems of the same directory in one node?");
 
    return GOTO_PREVIOUS_ITEM;
}
 
 
// may return NAME_FOUND, NAME_FOUND_INVISIBLE, NAME_NOT_FOUND
// FIXME: should add something like IOERROR
static int reiserfs_find_entry (struct inode * dir, const char * name, int namelen,
                                struct path * path_to_entry, struct reiserfs_dir_entry * de)
{
    struct cpu_key key_to_search;
    int retval;
 
 
    if (namelen > REISERFS_MAX_NAME (dir->i_sb->s_blocksize))
        return NAME_NOT_FOUND;
 
    /* we will search for this key in the tree */
    make_cpu_key (&key_to_search, dir,
                  get_third_component (dir->i_sb, name, namelen), TYPE_DIRENTRY, 3);
 
    while (1) {
        retval = search_by_entry_key (dir->i_sb, &key_to_search, path_to_entry, de);
        if (retval == IO_ERROR) {
            reiserfs_warning (dir->i_sb, "zam-7001: io error in %s\n", __FUNCTION__);
            return IO_ERROR;
        }
 
        /* compare names for all entries having given hash value */
        retval = linear_search_in_dir_item (&key_to_search, de, name, namelen);
        if (retval != GOTO_PREVIOUS_ITEM) {
            /* there is no need to scan directory anymore. Given entry found or does not exist */
            path_to_entry->pos_in_item = de->de_entry_num;
            return retval;
        }
 
        /* there is left neighboring item of this directory and given entry can be there */
        set_cpu_key_k_offset (&key_to_search, le_ih_k_offset (de->de_ih) - 1);
        pathrelse (path_to_entry);
 
    } /* while (1) */
}
 
 
static struct dentry * reiserfs_lookup (struct inode * dir, struct dentry * dentry)
{
    int retval;
    struct inode * inode = NULL;
    struct reiserfs_dir_entry de;
    INITIALIZE_PATH (path_to_entry);
 
    reiserfs_check_lock_depth("lookup") ;
 
    if (REISERFS_MAX_NAME (dir->i_sb->s_blocksize) < dentry->d_name.len)
        return ERR_PTR(-ENAMETOOLONG);
 
    de.de_gen_number_bit_string = 0;
    retval = reiserfs_find_entry (dir, dentry->d_name.name, dentry->d_name.len, &path_to_entry, &de);
    pathrelse (&path_to_entry);
    if (retval == NAME_FOUND) {
        inode = reiserfs_iget (dir->i_sb, (struct cpu_key *)&(de.de_dir_id));
        if (!inode || IS_ERR(inode)) {
            return ERR_PTR(-EACCES);
        }
    }
    if ( retval == IO_ERROR ) {
        return ERR_PTR(-EIO);
    }
 
    d_add(dentry, inode);
    return NULL;
}
 
/* add entry to the directory (entry can be hidden).
 
insert definition of when hidden directories are used here -Hans
 
 Does not mark dir   inode dirty, do it after successesfull call to it */
 
static int reiserfs_add_entry (struct reiserfs_transaction_handle *th, struct inode * dir,
                               const char * name, int namelen, struct inode * inode,
                               int visible)
{
    struct cpu_key entry_key;
    struct reiserfs_de_head * deh;
    INITIALIZE_PATH (path);
    struct reiserfs_dir_entry de;
    int bit_string [MAX_GENERATION_NUMBER / (sizeof(int) * 8) + 1];
    int gen_number;
    char small_buf[32+DEH_SIZE] ; /* 48 bytes now and we avoid kmalloc
                                     if we create file with short name */
    char * buffer;
    int buflen, paste_size;
    int retval;
 
 
    /* cannot allow items to be added into a busy deleted directory */
    if (!namelen)
        return -EINVAL;
 
    if (namelen > REISERFS_MAX_NAME (dir->i_sb->s_blocksize))
        return -ENAMETOOLONG;
 
    /* each entry has unique key. compose it */
    make_cpu_key (&entry_key, dir,
                  get_third_component (dir->i_sb, name, namelen), TYPE_DIRENTRY, 3);
 
    /* get memory for composing the entry */
    buflen = DEH_SIZE + ROUND_UP (namelen);
    if (buflen > sizeof (small_buf)) {
        buffer = reiserfs_kmalloc (buflen, GFP_NOFS, dir->i_sb);
        if (buffer == 0)
            return -ENOMEM;
    } else
        buffer = small_buf;
 
    paste_size = (get_inode_sd_version (dir) == STAT_DATA_V1) ? (DEH_SIZE + namelen) : buflen;
 
    /* fill buffer : directory entry head, name[, dir objectid | , stat data | ,stat data, dir objectid ] */
    deh = (struct reiserfs_de_head *)buffer;
    deh->deh_location = 0; /* JDM Endian safe if 0 */
    put_deh_offset( deh, cpu_key_k_offset( &entry_key ) );
    deh->deh_state = 0; /* JDM Endian safe if 0 */
    /* put key (ino analog) to de */
    deh->deh_dir_id = INODE_PKEY (inode)->k_dir_id; /* safe: k_dir_id is le */
    deh->deh_objectid = INODE_PKEY (inode)->k_objectid; /* safe: k_objectid is le */
 
    /* copy name */
    memcpy ((char *)(deh + 1), name, namelen);
    /* padd by 0s to the 4 byte boundary */
    padd_item ((char *)(deh + 1), ROUND_UP (namelen), namelen);
 
    /* entry is ready to be pasted into tree, set 'visibility' and 'stat data in entry' attributes */
    mark_de_without_sd (deh);
    visible ? mark_de_visible (deh) : mark_de_hidden (deh);
 
    /* find the proper place for the new entry */
    memset (bit_string, 0, sizeof (bit_string));
    de.de_gen_number_bit_string = (char *)bit_string;
    retval = reiserfs_find_entry (dir, name, namelen, &path, &de);
    if( retval != NAME_NOT_FOUND ) {
        if (buffer != small_buf)
            reiserfs_kfree (buffer, buflen, dir->i_sb);
        pathrelse (&path);
 
        if ( retval == IO_ERROR ) {
            return -EIO;
        }
 
        if (retval != NAME_FOUND) {
            reiserfs_warning (dir->i_sb, "zam-7002:%s: \"reiserfs_find_entry\" has returned"
                              " unexpected value (%d)\n", __FUNCTION__, retval);
       }
 
        return -EEXIST;
    }
 
    gen_number = find_first_zero_bit ((unsigned long *)bit_string, MAX_GENERATION_NUMBER + 1);
    if (gen_number > MAX_GENERATION_NUMBER) {
      /* there is no free generation number */
      reiserfs_warning (dir->i_sb, "reiserfs_add_entry: Congratulations! we have got hash function screwed up\n");
      if (buffer != small_buf)
          reiserfs_kfree (buffer, buflen, dir->i_sb);
      pathrelse (&path);
/*
 * Trivial changes by Alan Cox to remove EHASHCOLLISION for compatibility
 *
 * Trivial Changes:
 * Rights granted to Hans Reiser to redistribute under other terms providing
 * he accepts all liability including but not limited to patent, fitness
 * for purpose, and direct or indirect claims arising from failure to perform.
 *
 * NO WARRANTY
 * This is one of two lines that this fix consist of.
 */
      return -EBUSY;
      /* I think it was better to have an error code with a name that says
         what it means, but I choose not to fight over it.  Persons porting to
         other operating systems should consider keeping it as it was
         (return -EHASHCOLLISION;). -Hans */
    }
    /* adjust offset of directory enrty */
    put_deh_offset(deh, SET_GENERATION_NUMBER(deh_offset(deh), gen_number));
    set_cpu_key_k_offset (&entry_key, deh_offset(deh));
 
    /* update max-hash-collisions counter in reiserfs_sb_info */
    PROC_INFO_MAX( th -> t_super, max_hash_collisions, gen_number );
 
    if (gen_number != 0) {       /* we need to re-search for the insertion point */
      if (search_by_entry_key (dir->i_sb, &entry_key, &path, &de) != NAME_NOT_FOUND) {
            reiserfs_warning (dir->i_sb, "vs-7032: reiserfs_add_entry: "
                            "entry with this key (%K) already exists\n", &entry_key);
 
            if (buffer != small_buf)
                reiserfs_kfree (buffer, buflen, dir->i_sb);
            pathrelse (&path);
            /* Following line is 2nd line touched by Alan Cox' trivial fix */
            return -EBUSY;
      /* I think it was better to have an error code with a name that says
         what it means, but I choose not to fight over it.  Persons porting to
         other operating systems should consider keeping it as it was
         (return -EHASHCOLLISION;). -Hans */
        }
    }
 
    /* perform the insertion of the entry that we have prepared */
    retval = reiserfs_paste_into_item (th, &path, &entry_key, buffer, paste_size);
    if (buffer != small_buf)
        reiserfs_kfree (buffer, buflen, dir->i_sb);
    if (retval) {
        reiserfs_check_path(&path) ;
        return retval;
    }
 
    dir->i_size += paste_size;
    dir->i_blocks = ((dir->i_size + 511) >> 9);
    dir->i_mtime = dir->i_ctime = CURRENT_TIME;
    if (!S_ISDIR (inode->i_mode) && visible)
        // reiserfs_mkdir or reiserfs_rename will do that by itself
        reiserfs_update_sd (th, dir);
 
    reiserfs_check_path(&path) ;
    return 0;
}
 
/* quota utility function, call if you've had to abort after calling
** new_inode_init, and have not called reiserfs_new_inode yet.
** This should only be called on inodes that do not hav stat data
** inserted into the tree yet.
*/
static int drop_new_inode(struct inode *inode) {
    make_bad_inode(inode) ;
    iput(inode) ;
    return 0 ;
}
 
/* utility function that does setup for reiserfs_new_inode.
** DQUOT_ALLOC_INODE cannot be called inside a transaction, so we had
** to pull some bits of reiserfs_new_inode out into this func.
*/
static int new_inode_init(struct inode *inode, struct inode *dir, int mode) {
 
    /* the quota init calls have to know who to charge the quota to, so
    ** we have to set uid and gid here
    */
    inode->i_uid = current->fsuid;
    inode->i_mode = mode;
 
    if (dir->i_mode & S_ISGID) {
        inode->i_gid = dir->i_gid;
        if (S_ISDIR(mode))
            inode->i_mode |= S_ISGID;
    } else
        inode->i_gid = current->fsgid;
 
    return 0 ;
}
 
static int reiserfs_create (struct inode * dir, struct dentry *dentry, int mode)
{
    int retval;
    struct inode * inode;
    int jbegin_count = JOURNAL_PER_BALANCE_CNT * 2 ;
    struct reiserfs_transaction_handle th ;
 
    if (!(inode = new_inode(dir->i_sb))) {
        return -ENOMEM ;
    }
    retval = new_inode_init(inode, dir, mode) ;
    if (retval)
        return retval ;
 
    journal_begin(&th, dir->i_sb, jbegin_count) ;
    th.t_caller = "create" ;
    retval = reiserfs_new_inode (&th, dir, mode, 0, 0/*i_size*/, dentry, inode);
    if (retval) {
        goto out_failed ;
    }
 
    inode->i_op = &reiserfs_file_inode_operations;
    inode->i_fop = &reiserfs_file_operations;
    inode->i_mapping->a_ops = &reiserfs_address_space_operations ;
 
    retval = reiserfs_add_entry (&th, dir, dentry->d_name.name, dentry->d_name.len,
                                inode, 1/*visible*/);
    if (retval) {
        inode->i_nlink--;
        reiserfs_update_sd (&th, inode);
        journal_end(&th, dir->i_sb, jbegin_count) ;
        iput(inode) ;
        goto out_failed ;
    }
    reiserfs_update_inode_transaction(inode) ;
    reiserfs_update_inode_transaction(dir) ;
 
    d_instantiate(dentry, inode);
    journal_end(&th, dir->i_sb, jbegin_count) ;
    return 0;
 
out_failed:
    return retval ;
}
 
 
static int reiserfs_mknod (struct inode * dir, struct dentry *dentry, int mode, int rdev)
{
    int retval;
    struct inode * inode;
    struct reiserfs_transaction_handle th ;
    int jbegin_count = JOURNAL_PER_BALANCE_CNT * 3;
 
    if (!(inode = new_inode(dir->i_sb))) {
        return -ENOMEM ;
    }
    retval = new_inode_init(inode, dir, mode) ;
    if (retval)
        return retval ;
 
    journal_begin(&th, dir->i_sb, jbegin_count) ;
 
    retval = reiserfs_new_inode(&th, dir, mode, 0, 0/*i_size*/, dentry, inode);
    if (retval) {
        goto out_failed;
    }
 
    init_special_inode(inode, mode, rdev) ;
 
    //FIXME: needed for block and char devices only
    reiserfs_update_sd (&th, inode);
 
    reiserfs_update_inode_transaction(inode) ;
    reiserfs_update_inode_transaction(dir) ;
 
    retval = reiserfs_add_entry (&th, dir, dentry->d_name.name, dentry->d_name.len,
                                 inode, 1/*visible*/);
    if (retval) {
        inode->i_nlink--;
        reiserfs_update_sd (&th, inode);
        journal_end(&th, dir->i_sb, jbegin_count) ;
        iput(inode) ;
        goto out_failed;
    }
 
    d_instantiate(dentry, inode);
    journal_end(&th, dir->i_sb, jbegin_count) ;
    return 0;
 
out_failed:
    return retval ;
}
 
 
static int reiserfs_mkdir (struct inode * dir, struct dentry *dentry, int mode)
{
    int retval;
    struct inode * inode;
    struct reiserfs_transaction_handle th ;
    int jbegin_count = JOURNAL_PER_BALANCE_CNT * 3;
 
    mode = S_IFDIR | mode;
    if (!(inode = new_inode(dir->i_sb))) {
        return -ENOMEM ;
    }
    retval = new_inode_init(inode, dir, mode) ;
    if (retval)
        return retval ;
 
    journal_begin(&th, dir->i_sb, jbegin_count) ;
 
    /* inc the link count now, so another writer doesn't overflow it while
    ** we sleep later on.
    */
    INC_DIR_INODE_NLINK(dir)
 
#ifdef DISPLACE_NEW_PACKING_LOCALITIES
    /* set flag that new packing locality created and new blocks for the content     * of that directory are not displaced yet */
    dir->u.reiserfs_i.new_packing_locality = 1;
#endif
    retval = reiserfs_new_inode(&th, dir, mode, 0/*symlink*/,
                                old_format_only (dir->i_sb) ?
                                EMPTY_DIR_SIZE_V1 : EMPTY_DIR_SIZE,
                                dentry, inode) ;
    if (retval) {
        dir->i_nlink-- ;
        goto out_failed ;
    }
    reiserfs_update_inode_transaction(inode) ;
    reiserfs_update_inode_transaction(dir) ;
 
    inode->i_op = &reiserfs_dir_inode_operations;
    inode->i_fop = &reiserfs_dir_operations;
 
    // note, _this_ add_entry will not update dir's stat data
    retval = reiserfs_add_entry (&th, dir, dentry->d_name.name, dentry->d_name.len,
                                inode, 1/*visible*/);
    if (retval) {
        inode->i_nlink = 0;
        DEC_DIR_INODE_NLINK(dir);
        reiserfs_update_sd (&th, inode);
        journal_end(&th, dir->i_sb, jbegin_count) ;
        iput(inode) ;
        goto out_failed ;
    }
 
    // the above add_entry did not update dir's stat data
    reiserfs_update_sd (&th, dir);
 
    d_instantiate(dentry, inode);
    journal_end(&th, dir->i_sb, jbegin_count) ;
    return 0;
 
out_failed:
    return retval ;
}
 
static inline int reiserfs_empty_dir(struct inode *inode) {
    /* we can cheat because an old format dir cannot have
    ** EMPTY_DIR_SIZE, and a new format dir cannot have
    ** EMPTY_DIR_SIZE_V1.  So, if the inode is either size,
    ** regardless of disk format version, the directory is empty.
    */
    if (inode->i_size != EMPTY_DIR_SIZE &&
        inode->i_size != EMPTY_DIR_SIZE_V1) {
        return 0 ;
    }
    return 1 ;
}
 
 
static int reiserfs_rmdir (struct inode * dir, struct dentry *dentry)
{
    int retval;
    struct inode * inode;
    int windex ;
    struct reiserfs_transaction_handle th ;
    int jbegin_count;
    INITIALIZE_PATH (path);
    struct reiserfs_dir_entry de;
 
 
    /* we will be doing 2 balancings and update 2 stat data */
    jbegin_count = JOURNAL_PER_BALANCE_CNT * 2 + 2;
 
    journal_begin(&th, dir->i_sb, jbegin_count) ;
    windex = push_journal_writer("reiserfs_rmdir") ;
 
    de.de_gen_number_bit_string = 0;
    if ( (retval = reiserfs_find_entry (dir, dentry->d_name.name, dentry->d_name.len, &path, &de)) == NAME_NOT_FOUND) {
        retval = -ENOENT;
        goto end_rmdir;
    } else if ( retval == IO_ERROR) {
        retval = -EIO;
        goto end_rmdir;
    }
 
    inode = dentry->d_inode;
 
    reiserfs_update_inode_transaction(inode) ;
    reiserfs_update_inode_transaction(dir) ;
 
    if (de.de_objectid != inode->i_ino) {
        // FIXME: compare key of an object and a key found in the
        // entry
        retval = -EIO;
        goto end_rmdir;
    }
    if (!reiserfs_empty_dir(inode)) {
        retval = -ENOTEMPTY;
        goto end_rmdir;
    }
 
    /* cut entry from dir directory */
    retval = reiserfs_cut_from_item (&th, &path, &(de.de_entry_key), dir,
                                     NULL, /* page */
                                     0/*new file size - not used here*/);
    if (retval < 0)
        goto end_rmdir;
 
    if ( inode->i_nlink != 2 && inode->i_nlink != 1 )
        reiserfs_warning ( inode->i_sb, "reiserfs_rmdir: empty directory has nlink != 2 (%d)\n", inode->i_nlink);
 
    inode->i_nlink = 0;
    inode->i_ctime = dir->i_ctime = dir->i_mtime = CURRENT_TIME;
    reiserfs_update_sd (&th, inode);
 
    DEC_DIR_INODE_NLINK(dir)
    dir->i_size -= (DEH_SIZE + de.de_entrylen);
    dir->i_blocks = ((dir->i_size + 511) >> 9);
    reiserfs_update_sd (&th, dir);
 
    /* prevent empty directory from getting lost */
    add_save_link (&th, inode, 0/* not truncate */);
 
    pop_journal_writer(windex) ;
    journal_end(&th, dir->i_sb, jbegin_count) ;
    reiserfs_check_path(&path) ;
    return 0;
 
 end_rmdir:
    /* we must release path, because we did not call
       reiserfs_cut_from_item, or reiserfs_cut_from_item does not
       release path if operation was not complete */
    pathrelse (&path);
    pop_journal_writer(windex) ;
    journal_end(&th, dir->i_sb, jbegin_count) ;
    return retval;
}
 
 
static int reiserfs_unlink (struct inode * dir, struct dentry *dentry)
{
    int retval;
    struct inode * inode;
    struct reiserfs_dir_entry de;
    INITIALIZE_PATH (path);
    int windex ;
    struct reiserfs_transaction_handle th ;
    int jbegin_count;
    unsigned long savelink;
 
    inode = dentry->d_inode;
 
    /* in this transaction we can be doing at max two balancings and update
       two stat datas */
    jbegin_count = JOURNAL_PER_BALANCE_CNT * 2 + 2;
 
    journal_begin(&th, dir->i_sb, jbegin_count) ;
    windex = push_journal_writer("reiserfs_unlink") ;
 
    de.de_gen_number_bit_string = 0;
    if ( (retval = reiserfs_find_entry (dir, dentry->d_name.name, dentry->d_name.len, &path, &de)) == NAME_NOT_FOUND) {
        retval = -ENOENT;
        goto end_unlink;
    } else if (retval == IO_ERROR) {
        retval = -EIO;
        goto end_unlink;
    }
 
    reiserfs_update_inode_transaction(inode) ;
    reiserfs_update_inode_transaction(dir) ;
 
    if (de.de_objectid != inode->i_ino) {
        // FIXME: compare key of an object and a key found in the
        // entry
        retval = -EIO;
        goto end_unlink;
    }
 
    if (!inode->i_nlink) {
        reiserfs_warning(inode->i_sb, "reiserfs_unlink: deleting nonexistent file (%s:%lu), %d\n",
               kdevname(inode->i_dev), inode->i_ino, inode->i_nlink);
        inode->i_nlink = 1;
    }
 
    inode->i_nlink--;
 
    /*
     * we schedule before doing the add_save_link call, save the link
     * count so we don't race
     */
    savelink = inode->i_nlink;
 
 
    retval = reiserfs_cut_from_item (&th, &path, &(de.de_entry_key), dir, NULL, 0);
    if (retval < 0) {
        inode->i_nlink++;
        goto end_unlink;
    }
    inode->i_ctime = CURRENT_TIME;
    reiserfs_update_sd (&th, inode);
 
    dir->i_size -= (de.de_entrylen + DEH_SIZE);
    dir->i_blocks = ((dir->i_size + 511) >> 9);
    dir->i_ctime = dir->i_mtime = CURRENT_TIME;
    reiserfs_update_sd (&th, dir);
 
    if (!savelink)
       /* prevent file from getting lost */
       add_save_link (&th, inode, 0/* not truncate */);
 
    pop_journal_writer(windex) ;
    journal_end(&th, dir->i_sb, jbegin_count) ;
    reiserfs_check_path(&path) ;
    return 0;
 
 end_unlink:
    pathrelse (&path);
    pop_journal_writer(windex) ;
    journal_end(&th, dir->i_sb, jbegin_count) ;
    reiserfs_check_path(&path) ;
    return retval;
}
 
 
static int reiserfs_symlink (struct inode * parent_dir, struct dentry * dentry, const char * symname)
{
    int retval;
    struct inode * inode;
    char * name;
    int item_len;
    int mode = S_IFLNK | S_IRWXUGO ;
    struct reiserfs_transaction_handle th ;
    int jbegin_count = JOURNAL_PER_BALANCE_CNT * 3;
 
 
    if (!(inode = new_inode(parent_dir->i_sb))) {
        return -ENOMEM ;
    }
    retval = new_inode_init(inode, parent_dir, mode) ;
    if (retval) {
        return retval ;
    }
 
    item_len = ROUND_UP (strlen (symname));
    if (item_len > MAX_DIRECT_ITEM_LEN (parent_dir->i_sb->s_blocksize)) {
        retval = -ENAMETOOLONG;
        drop_new_inode(inode) ;
        goto out_failed ;
    }
 
    name = reiserfs_kmalloc (item_len, GFP_NOFS, parent_dir->i_sb);
    if (!name) {
        retval = -ENOMEM;
        drop_new_inode(inode) ;
        goto out_failed ;
    }
    memcpy (name, symname, strlen (symname));
    padd_item (name, item_len, strlen (symname));
 
    journal_begin(&th, parent_dir->i_sb, jbegin_count) ;
 
    retval = reiserfs_new_inode(&th, parent_dir, mode, name,
                                strlen(symname), dentry, inode) ;
    reiserfs_kfree (name, item_len, parent_dir->i_sb);
    if (retval) {
        goto out_failed ;
    }
 
    reiserfs_update_inode_transaction(inode) ;
    reiserfs_update_inode_transaction(parent_dir) ;
 
    inode->i_op = &page_symlink_inode_operations;
    inode->i_mapping->a_ops = &reiserfs_address_space_operations;
 
    // must be sure this inode is written with this transaction
    //
    //reiserfs_update_sd (&th, inode, READ_BLOCKS);
 
    retval = reiserfs_add_entry (&th, parent_dir, dentry->d_name.name, dentry->d_name.len,
                                 inode, 1/*visible*/);
    if (retval) {
        inode->i_nlink--;
        reiserfs_update_sd (&th, inode);
        journal_end(&th, parent_dir->i_sb, jbegin_count) ;
        iput(inode) ;
        goto out_failed ;
    }
 
    d_instantiate(dentry, inode);
    journal_end(&th, parent_dir->i_sb, jbegin_count) ;
    return 0;
 
out_failed:
    return retval ;
}
 
 
static int reiserfs_link (struct dentry * old_dentry, struct inode * dir, struct dentry * dentry)
{
    int retval;
    struct inode *inode = old_dentry->d_inode;
    int windex ;
    struct reiserfs_transaction_handle th ;
    int jbegin_count = JOURNAL_PER_BALANCE_CNT * 3;
    time_t ctime;
 
 
    if (S_ISDIR(inode->i_mode))
        return -EPERM;
 
    if (inode->i_nlink >= REISERFS_LINK_MAX) {
        //FIXME: sd_nlink is 32 bit for new files
        return -EMLINK;
    }
    if (inode->i_nlink == 0) {
        return -ENOENT;
    }
 
    /* inc before scheduling so reiserfs_unlink knows we are here */
    inode->i_nlink++;
 
    journal_begin(&th, dir->i_sb, jbegin_count) ;
    windex = push_journal_writer("reiserfs_link") ;
 
    /* create new entry */
    retval = reiserfs_add_entry (&th, dir, dentry->d_name.name, dentry->d_name.len,
                                 inode, 1/*visible*/);
 
    reiserfs_update_inode_transaction(inode) ;
    reiserfs_update_inode_transaction(dir) ;
 
    if (retval) {
        inode->i_nlink--;
        pop_journal_writer(windex) ;
        journal_end(&th, dir->i_sb, jbegin_count) ;
        return retval;
    }
 
    ctime = CURRENT_TIME;
    inode->i_ctime = ctime;
    reiserfs_update_sd (&th, inode);
 
    atomic_inc(&inode->i_count) ;
    d_instantiate(dentry, inode);
    pop_journal_writer(windex) ;
    journal_end(&th, dir->i_sb, jbegin_count) ;
    return 0;
}
 
 
// de contains information pointing to an entry which 
static int de_still_valid (const char * name, int len, struct reiserfs_dir_entry * de)
{
    struct reiserfs_dir_entry tmp = *de;
 
    // recalculate pointer to name and name length
    set_de_name_and_namelen (&tmp);
    // FIXME: could check more
    if (tmp.de_namelen != len || memcmp (name, de->de_name, len))
        return 0;
    return 1;
}
 
 
static int entry_points_to_object (const char * name, int len, struct reiserfs_dir_entry * de, struct inode * inode)
{
    if (!de_still_valid (name, len, de))
        return 0;
 
    if (inode) {
        if (!de_visible (de->de_deh + de->de_entry_num))
            reiserfs_panic (0, "vs-7042: entry_points_to_object: entry must be visible");
        return (de->de_objectid == inode->i_ino) ? 1 : 0;
    }
 
    /* this must be added hidden entry */
    if (de_visible (de->de_deh + de->de_entry_num))
        reiserfs_panic (0, "vs-7043: entry_points_to_object: entry must be visible");
 
    return 1;
}
 
 
/* sets key of objectid the entry has to point to */
static void set_ino_in_dir_entry (struct reiserfs_dir_entry * de, struct key * key)
{
    /* JDM These operations are endian safe - both are le */
    de->de_deh[de->de_entry_num].deh_dir_id = key->k_dir_id;
    de->de_deh[de->de_entry_num].deh_objectid = key->k_objectid;
}
 
 
/*
 * process, that is going to call fix_nodes/do_balance must hold only
 * one path. If it holds 2 or more, it can get into endless waiting in
 * get_empty_nodes or its clones
 */
static int reiserfs_rename (struct inode * old_dir, struct dentry *old_dentry,
                            struct inode * new_dir, struct dentry *new_dentry)
{
    int retval;
    INITIALIZE_PATH (old_entry_path);
    INITIALIZE_PATH (new_entry_path);
    INITIALIZE_PATH (dot_dot_entry_path);
    struct item_head new_entry_ih, old_entry_ih, dot_dot_ih ;
    struct reiserfs_dir_entry old_de, new_de, dot_dot_de;
    struct inode * old_inode, * new_dentry_inode;
    int windex ;
    struct reiserfs_transaction_handle th ;
    int jbegin_count ;
    umode_t old_inode_mode;
    time_t ctime;
    unsigned long savelink = 1;
 
 
    /* two balancings: old name removal, new name insertion or "save" link,
       stat data updates: old directory and new directory and maybe block
       containing ".." of renamed directory */
    jbegin_count = JOURNAL_PER_BALANCE_CNT * 3 + 3;
 
    old_inode = old_dentry->d_inode;
    new_dentry_inode = new_dentry->d_inode;
 
    // make sure, that oldname still exists and points to an object we
    // are going to rename
    old_de.de_gen_number_bit_string = 0;
    retval = reiserfs_find_entry (old_dir, old_dentry->d_name.name, old_dentry->d_name.len,
                                  &old_entry_path, &old_de);
    pathrelse (&old_entry_path);
    if (retval == IO_ERROR)
        return -EIO;
 
    if (retval != NAME_FOUND || old_de.de_objectid != old_inode->i_ino) {
        return -ENOENT;
    }
 
    old_inode_mode = old_inode->i_mode;
    if (S_ISDIR(old_inode_mode)) {
        // make sure, that directory being renamed has correct ".." 
        // and that its new parent directory has not too many links
        // already
 
        if (new_dentry_inode) {
            if (!reiserfs_empty_dir(new_dentry_inode)) {
                return -ENOTEMPTY;
            }
        }
 
        /* directory is renamed, its parent directory will be changed,
        ** so find ".." entry
        */
        dot_dot_de.de_gen_number_bit_string = 0;
        retval = reiserfs_find_entry (old_inode, "..", 2, &dot_dot_entry_path, &dot_dot_de);
        pathrelse (&dot_dot_entry_path);
        if (retval != NAME_FOUND)
            return -EIO;
 
        /* inode number of .. must equal old_dir->i_ino */
        if (dot_dot_de.de_objectid != old_dir->i_ino)
            return -EIO;
    }
 
    journal_begin(&th, old_dir->i_sb, jbegin_count) ;
    windex = push_journal_writer("reiserfs_rename") ;
 
    /* add new entry (or find the existing one) */
    retval = reiserfs_add_entry (&th, new_dir, new_dentry->d_name.name, new_dentry->d_name.len,
                                 old_inode, 0);
    if (retval == -EEXIST) {
        if (!new_dentry_inode) {
            reiserfs_panic (old_dir->i_sb,
                            "vs-7050: new entry is found, new inode == 0\n");
        }
    } else if (retval) {
        pop_journal_writer(windex) ;
        journal_end(&th, old_dir->i_sb, jbegin_count) ;
        return retval;
    }
 
    reiserfs_update_inode_transaction(old_dir) ;
    reiserfs_update_inode_transaction(new_dir) ;
 
    /* this makes it so an fsync on an open fd for the old name will
    ** commit the rename operation
    */
    reiserfs_update_inode_transaction(old_inode) ;
 
    if (new_dentry_inode)
        reiserfs_update_inode_transaction(new_dentry_inode) ;
 
    while (1) {
        // look for old name using corresponding entry key (found by reiserfs_find_entry)
        if (search_by_entry_key (new_dir->i_sb, &old_de.de_entry_key, &old_entry_path, &old_de) != NAME_FOUND)
            BUG ();
 
        copy_item_head(&old_entry_ih, get_ih(&old_entry_path)) ;
 
        reiserfs_prepare_for_journal(old_inode->i_sb, old_de.de_bh, 1) ;
 
        // look for new name by reiserfs_find_entry
        new_de.de_gen_number_bit_string = 0;
        retval = reiserfs_find_entry (new_dir, new_dentry->d_name.name, new_dentry->d_name.len,
                                      &new_entry_path, &new_de);
        // reiserfs_add_entry should not return IO_ERROR, because it is called with essentially same parameters from
        // reiserfs_add_entry above, and we'll catch any i/o errors before we get here.
        if (retval != NAME_FOUND_INVISIBLE && retval != NAME_FOUND)
            BUG ();
 
        copy_item_head(&new_entry_ih, get_ih(&new_entry_path)) ;
 
        reiserfs_prepare_for_journal(old_inode->i_sb, new_de.de_bh, 1) ;
 
        if (S_ISDIR(old_inode->i_mode)) {
            if (search_by_entry_key (new_dir->i_sb, &dot_dot_de.de_entry_key, &dot_dot_entry_path, &dot_dot_de) != NAME_FOUND)
                BUG ();
            copy_item_head(&dot_dot_ih, get_ih(&dot_dot_entry_path)) ;
            // node containing ".." gets into transaction
            reiserfs_prepare_for_journal(old_inode->i_sb, dot_dot_de.de_bh, 1) ;
        }
                                /* we should check seals here, not do
                                   this stuff, yes? Then, having
                                   gathered everything into RAM we
                                   should lock the buffers, yes?  -Hans */
                                /* probably.  our rename needs to hold more
                                ** than one path at once.  The seals would
                                ** have to be written to deal with multi-path
                                ** issues -chris
                                */
        /* sanity checking before doing the rename - avoid races many
        ** of the above checks could have scheduled.  We have to be
        ** sure our items haven't been shifted by another process.
        */
        if (item_moved(&new_entry_ih, &new_entry_path) ||
            !entry_points_to_object(new_dentry->d_name.name,
                                    new_dentry->d_name.len,
                                    &new_de, new_dentry_inode) ||
            item_moved(&old_entry_ih, &old_entry_path) ||
            !entry_points_to_object (old_dentry->d_name.name,
                                     old_dentry->d_name.len,
                                     &old_de, old_inode)) {
            reiserfs_restore_prepared_buffer (old_inode->i_sb, new_de.de_bh);
            reiserfs_restore_prepared_buffer (old_inode->i_sb, old_de.de_bh);
            if (S_ISDIR(old_inode_mode))
                reiserfs_restore_prepared_buffer (old_inode->i_sb, dot_dot_de.de_bh);
            continue;
        }
        if (S_ISDIR(old_inode_mode)) {
            if ( item_moved(&dot_dot_ih, &dot_dot_entry_path) ||
                 !entry_points_to_object ( "..", 2, &dot_dot_de, old_dir) ) {
                reiserfs_restore_prepared_buffer (old_inode->i_sb, old_de.de_bh);
                reiserfs_restore_prepared_buffer (old_inode->i_sb, new_de.de_bh);
                reiserfs_restore_prepared_buffer (old_inode->i_sb, dot_dot_de.de_bh);
                continue;
            }
        }
 
 
        RFALSE( S_ISDIR(old_inode_mode) &&
                !reiserfs_buffer_prepared(dot_dot_de.de_bh), "" );
 
        break;
    }
 
    /* ok, all the changes can be done in one fell swoop when we
       have claimed all the buffers needed.*/
 
    mark_de_visible (new_de.de_deh + new_de.de_entry_num);
    set_ino_in_dir_entry (&new_de, INODE_PKEY (old_inode));
    journal_mark_dirty (&th, old_dir->i_sb, new_de.de_bh);
 
    mark_de_hidden (old_de.de_deh + old_de.de_entry_num);
    journal_mark_dirty (&th, old_dir->i_sb, old_de.de_bh);
    old_dir->i_ctime = old_dir->i_mtime = CURRENT_TIME;
    new_dir->i_ctime = new_dir->i_mtime = CURRENT_TIME;
 
    if (new_dentry_inode) {
        // adjust link number of the victim
        if (S_ISDIR(new_dentry_inode->i_mode)) {
            new_dentry_inode->i_nlink  = 0;
        } else {
            new_dentry_inode->i_nlink--;
        }
        ctime = CURRENT_TIME;
        new_dentry_inode->i_ctime = ctime;
        savelink = new_dentry_inode->i_nlink;
    }
 
    if (S_ISDIR(old_inode_mode)) {
        // adjust ".." of renamed directory 
        set_ino_in_dir_entry (&dot_dot_de, INODE_PKEY (new_dir));
        journal_mark_dirty (&th, new_dir->i_sb, dot_dot_de.de_bh);
 
        if (!new_dentry_inode)
            /* there (in new_dir) was no directory, so it got new link
               (".."  of renamed directory) */
            INC_DIR_INODE_NLINK(new_dir);
 
        /* old directory lost one link - ".. " of renamed directory */
        DEC_DIR_INODE_NLINK(old_dir);
    }
 
    // looks like in 2.3.99pre3 brelse is atomic. so we can use pathrelse
    pathrelse (&new_entry_path);
    pathrelse (&dot_dot_entry_path);
 
    // FIXME: this reiserfs_cut_from_item's return value may screw up
    // anybody, but it will panic if will not be able to find the
    // entry. This needs one more clean up
    if (reiserfs_cut_from_item (&th, &old_entry_path, &(old_de.de_entry_key), old_dir, NULL, 0) < 0)
        reiserfs_warning ((&th)->t_super, "vs-7060: reiserfs_rename: couldn't not cut old name. Fsck later?\n");
 
    old_dir->i_size -= DEH_SIZE + old_de.de_entrylen;
    old_dir->i_blocks = ((old_dir->i_size + 511) >> 9);
 
    reiserfs_update_sd (&th, old_dir);
    reiserfs_update_sd (&th, new_dir);
 
    if (new_dentry_inode) {
        if (savelink == 0)
            add_save_link (&th, new_dentry_inode, 0/* not truncate */);
        reiserfs_update_sd (&th, new_dentry_inode);
    }
 
    pop_journal_writer(windex) ;
    journal_end(&th, old_dir->i_sb, jbegin_count) ;
    return 0;
}
 
 
 
/*
 * directories can handle most operations...
 */
struct inode_operations reiserfs_dir_inode_operations = {
  //&reiserfs_dir_operations,   /* default_file_ops */
    create:     reiserfs_create,
    lookup:     reiserfs_lookup,
    link:       reiserfs_link,
    unlink:     reiserfs_unlink,
    symlink:    reiserfs_symlink,
    mkdir:      reiserfs_mkdir,
    rmdir:      reiserfs_rmdir,
    mknod:      reiserfs_mknod,
    rename:     reiserfs_rename,
};
 
Browse

Tools

Subversion Repositories or1k

[/] [or1k/] [tags/] [LINUX_2_4_26_OR32/] [linux/] [linux-2.4/] [fs/] [reiserfs/] [namei.c] - Blame information for rev 1765

Line No.	Rev	Author	Line
1	1275	phoenix	`/*`
2			`* Copyright 2000-2002 by Hans Reiser, licensing governed by reiserfs/README`
3			`*/`
4
5			`#include <linux/config.h>`
6			`#include <linux/sched.h>`
7			`#include <linux/bitops.h>`
8			`#include <linux/reiserfs_fs.h>`
9			`#include <linux/smp_lock.h>`
10
11			`#define INC_DIR_INODE_NLINK(i) if (i->i_nlink != 1) { i->i_nlink++; if (i->i_nlink >= REISERFS_LINK_MAX) i->i_nlink=1; }`
12			`#define DEC_DIR_INODE_NLINK(i) if (i->i_nlink != 1) i->i_nlink--;`
13
14			`// directory item contains array of entry headers. This performs`
15			`// binary search through that array`
16			`static int bin_search_in_dir_item (struct reiserfs_dir_entry * de, loff_t off)`
17			`{`
18			`struct item_head * ih = de->de_ih;`
19			`struct reiserfs_de_head * deh = de->de_deh;`
20			`int rbound, lbound, j;`
21
22			`lbound = 0;`
23			`rbound = I_ENTRY_COUNT (ih) - 1;`
24
25			`for (j = (rbound + lbound) / 2; lbound <= rbound; j = (rbound + lbound) / 2) {`
26			`if (off < deh_offset (deh + j)) {`
27			`rbound = j - 1;`
28			`continue;`
29			`}`
30			`if (off > deh_offset (deh + j)) {`
31			`lbound = j + 1;`
32			`continue;`
33			`}`
34			`// this is not name found, but matched third key component`
35			`de->de_entry_num = j;`
36			`return NAME_FOUND;`
37			`}`
38
39			`de->de_entry_num = lbound;`
40			`return NAME_NOT_FOUND;`