truncate.c

带中文注释的Linux+0.11+源代码

/*
* linux/fs/truncate.c
*
* (C) 1991 Linus Torvalds
*/

#include <linux/sched.h>	// 调度程序头文件，定义了任务结构task_struct、初始任务0 的数据，
// 还有一些有关描述符参数设置和获取的嵌入式汇编函数宏语句。

#include <sys/stat.h>		// 文件状态头文件。含有文件或文件系统状态结构stat{}和常量。

//// 释放一次间接块。
static void
free_ind (int dev, int block)
{
  struct buffer_head *bh;
  unsigned short *p;
  int i;

// 如果逻辑块号为0，则返回。
  if (!block)
    return;
// 读取一次间接块，并释放其上表明使用的所有逻辑块，然后释放该一次间接块的缓冲区。
  if (bh = bread (dev, block))
    {
      p = (unsigned short *) bh->b_data;	// 指向数据缓冲区。
      for (i = 0; i < 512; i++, p++)	// 每个逻辑块上可有512 个块号。
	if (*p)
	  free_block (dev, *p);	// 释放指定的逻辑块。
      brelse (bh);		// 释放缓冲区。
    }
//其它字段
//i_zone[0]
//i_zone[1]
//i_zone[2]
//i_zone[3]
//i_zone[4]
//i_zone[5]
//i_zone[6]
//i 节点
//直接块号
//一次间接块
//二次间接块
//的一级块
//二次间接块
//的二级块
//一次间接块号
//二次间接块号
//i_zone[7]
//i_zone[8]
// 释放设备上的一次间接块。
  free_block (dev, block);
}

//// 释放二次间接块。
static void
free_dind (int dev, int block)
{
  struct buffer_head *bh;
  unsigned short *p;
  int i;

// 如果逻辑块号为0，则返回。
  if (!block)
    return;
// 读取二次间接块的一级块，并释放其上表明使用的所有逻辑块，然后释放该一级块的缓冲区。
  if (bh = bread (dev, block))
    {
      p = (unsigned short *) bh->b_data;	// 指向数据缓冲区。
      for (i = 0; i < 512; i++, p++)	// 每个逻辑块上可连接512 个二级块。
	if (*p)
	  free_ind (dev, *p);	// 释放所有一次间接块。
      brelse (bh);		// 释放缓冲区。
    }
// 最后释放设备上的二次间接块。
  free_block (dev, block);
}

//// 将节点对应的文件长度截为0，并释放占用的设备空间。
void
truncate (struct m_inode *inode)
{
  int i;

// 如果不是常规文件或者是目录文件，则返回。
  if (!(S_ISREG (inode->i_mode) || S_ISDIR (inode->i_mode)))
    return;
// 释放i 节点的7 个直接逻辑块，并将这7 个逻辑块项全置零。
  for (i = 0; i < 7; i++)
    if (inode->i_zone[i])
      {				// 如果块号不为0，则释放之。
	free_block (inode->i_dev, inode->i_zone[i]);
	inode->i_zone[i] = 0;
      }
  free_ind (inode->i_dev, inode->i_zone[7]);	// 释放一次间接块。
  free_dind (inode->i_dev, inode->i_zone[8]);	// 释放二次间接块。
  inode->i_zone[7] = inode->i_zone[8] = 0;	// 逻辑块项7、8 置零。
  inode->i_size = 0;		// 文件大小置零。
  inode->i_dirt = 1;		// 置节点已修改标志。
  inode->i_mtime = inode->i_ctime = CURRENT_TIME;	// 重置文件和节点修改时间为当前时间。
}