ramdisk.c

带中文注释的 linux 0.11 源代码0.11,很好的

/*
* linux/kernel/blk_drv/ramdisk.c
*
* Written by Theodore Ts'o, 12/2/91
*/
/* 由Theodore Ts'o 编制，12/2/91
*/
// Theodore Ts'o (Ted Ts'o)是linux 社区中的著名人物。Linux 在世界范围内的流行也有他很大的
// 功劳，早在Linux 操作系统刚问世时，他就怀着极大的热情为linux 的发展提供了maillist，并
// 在北美洲地区最早设立了linux 的ftp 站点（tsx-11.mit.edu），而且至今仍然为广大linux 用户
// 提供服务。他对linux 作出的最大贡献之一是提出并实现了ext2 文件系统。该文件系统已成为
// linux 世界中事实上的文件系统标准。最近他又推出了ext3 文件系统，大大提高了文件系统的
// 稳定性和访问效率。作为对他的推崇，第97 期（2002 年5 月）的linuxjournal 期刊将他作为
// 了封面人物，并对他进行了采访。目前，他为IBM linux 技术中心工作，并从事着有关LSB
// (Linux Standard Base)等方面的工作。(他的主页：http://thunk.org/tytso/)

#include <string.h>		// 字符串头文件。主要定义了一些有关字符串操作的嵌入函数。

#include <linux/config.h>	// 内核配置头文件。定义键盘语言和硬盘类型（HD_TYPE）可选项。
#include <linux/sched.h>	// 调度程序头文件，定义了任务结构task_struct、初始任务0 的数据，
// 还有一些有关描述符参数设置和获取的嵌入式汇编函数宏语句。
#include <linux/fs.h>		// 文件系统头文件。定义文件表结构（file,buffer_head,m_inode 等）。
#include <linux/kernel.h>	// 内核头文件。含有一些内核常用函数的原形定义。
#include <asm/system.h>		// 系统头文件。定义了设置或修改描述符/中断门等的嵌入式汇编宏。
#include <asm/segment.h>	// 段操作头文件。定义了有关段寄存器操作的嵌入式汇编函数。
#include <asm/memory.h>		// 内存拷贝头文件。含有memcpy()嵌入式汇编宏函数。

#define MAJOR_NR 1		// 内存主设备号是1。
#include "blk.h"

char *rd_start;			// 虚拟盘在内存中的起始位置。在52 行初始化函数rd_init()中
// 确定。参见(init/main.c,124)（缩写rd_代表ramdisk_）。
int rd_length = 0;		// 虚拟盘所占内存大小（字节）。

// 执行虚拟盘(ramdisk)读写操作。程序结构与do_hd_request()类似(kernel/blk_drv/hd.c,294)。
void
do_rd_request (void)
{
  int len;
  char *addr;

  INIT_REQUEST;			// 检测请求的合法性(参见kernel/blk_drv/blk.h,127)。
// 下面语句取得ramdisk 的起始扇区对应的内存起始位置和内存长度。
// 其中sector << 9 表示sector * 512，CURRENT 定义为(blk_dev[MAJOR_NR].current_request)。
  addr = rd_start + (CURRENT->sector << 9);
  len = CURRENT->nr_sectors << 9;
// 如果子设备号不为1 或者对应内存起始位置>虚拟盘末尾，则结束该请求，并跳转到repeat 处
// （定义在28 行的INIT_REQUEST 内开始处）。
  if ((MINOR (CURRENT->dev) != 1) || (addr + len > rd_start + rd_length))
    {
      end_request (0);
      goto repeat;
    }
// 如果是写命令(WRITE)，则将请求项中缓冲区的内容复制到addr 处，长度为len 字节。
  if (CURRENT->cmd == WRITE)
    {
      (void) memcpy (addr, CURRENT->buffer, len);
// 如果是读命令(READ)，则将addr 开始的内容复制到请求项中缓冲区中，长度为len 字节。
    }
  else if (CURRENT->cmd == READ)
    {
      (void) memcpy (CURRENT->buffer, addr, len);
// 否则显示命令不存在，死机。
    }
  else
    panic ("unknown ramdisk-command");
// 请求项成功后处理，置更新标志。并继续处理本设备的下一请求项。
  end_request (1);
  goto repeat;
}

/*
* Returns amount of memory which needs to be reserved.
*/
/* 返回内存虚拟盘ramdisk 所需的内存量 */
// 虚拟盘初始化函数。确定虚拟盘在内存中的起始地址，长度。并对整个虚拟盘区清零。
long
rd_init (long mem_start, int length)
{
  int i;
  char *cp;

  blk_dev[MAJOR_NR].request_fn = DEVICE_REQUEST;	// do_rd_request()。
  rd_start = (char *) mem_start;
  rd_length = length;
  cp = rd_start;
  for (i = 0; i < length; i++)
    *cp++ = '\0';
  return (length);
}

/*
* If the root device is the ram disk, try to load it.
* In order to do this, the root device is originally set to the
* floppy, and we later change it to be ram disk.
*/
/*
* 如果根文件系统设备(root device)是ramdisk 的话，则尝试加载它。root device 原先是指向
* 软盘的，我们将它改成指向ramdisk。
*/
//// 加载根文件系统到ramdisk。
void
rd_load (void)
{
  struct buffer_head *bh;
  struct super_block s;
  int block = 256;		/* Start at block 256 */
  int i = 1;
  int nblocks;
  char *cp;			/* Move pointer */

  if (!rd_length)		// 如果ramdisk 的长度为零，则退出。
    return;
  printk ("Ram disk: %d bytes, starting at 0x%x\n", rd_length, (int) rd_start);	// 显示ramdisk 的大小以及内存起始位置。
  if (MAJOR (ROOT_DEV) != 2)	// 如果此时根文件设备不是软盘，则退出。
    return;
// 读软盘块256+1,256,256+2。breada()用于读取指定的数据块，并标出还需要读的块，然后返回
// 含有数据块的缓冲区指针。如果返回NULL，则表示数据块不可读(fs/buffer.c,322)。
// 这里block+1 是指磁盘上的超级块。
  bh = breada (ROOT_DEV, block + 1, block, block + 2, -1);
  if (!bh)
    {
      printk ("Disk error while looking for ramdisk!\n");
      return;
    }
// 将s 指向缓冲区中的磁盘超级块。(d_super_block 磁盘中超级块结构)。
  *((struct d_super_block *) &s) = *((struct d_super_block *) bh->b_data);
  brelse (bh);			// [?? 为什么数据没有复制就立刻释放呢？]
  if (s.s_magic != SUPER_MAGIC)	// 如果超级块中魔数不对，则说明不是minix 文件系统。
/* No ram disk image present, assume normal floppy boot */
/* 磁盘中没有ramdisk 映像文件，退出执行通常的软盘引导 */
    return;
// 块数 = 逻辑块数(区段数) * 2^(每区段块数的次方)。
// 如果数据块数大于内存中虚拟盘所能容纳的块数，则不能加载，显示出错信息并返回。否则显示
// 加载数据块信息。
  nblocks = s.s_nzones << s.s_log_zone_size;
  if (nblocks > (rd_length >> BLOCK_SIZE_BITS))
    {
      printk ("Ram disk image too big! (%d blocks, %d avail)\n",
	      nblocks, rd_length >> BLOCK_SIZE_BITS);
      return;
    }
  printk ("Loading %d bytes into ram disk... 0000k",
	  nblocks << BLOCK_SIZE_BITS);
// cp 指向虚拟盘起始处，然后将磁盘上的根文件系统映象文件复制到虚拟盘上。
  cp = rd_start;
  while (nblocks)
    {
      if (nblocks > 2)		// 如果需读取的块数多于3 快则采用超前预读方式读数据块。
	bh = breada (ROOT_DEV, block, block + 1, block + 2, -1);
      else			// 否则就单块读取。
	bh = bread (ROOT_DEV, block);
      if (!bh)
	{
	  printk ("I/O error on block %d, aborting load\n", block);
	  return;
	}
      (void) memcpy (cp, bh->b_data, BLOCK_SIZE);	// 将缓冲区中的数据复制到cp 处。
      brelse (bh);		// 释放缓冲区。
      printk ("\010\010\010\010\010%4dk", i);	// 打印加载块计数值。
      cp += BLOCK_SIZE;		// 虚拟盘指针前移。
      block++;
      nblocks--;
      i++;
    }
  printk ("\010\010\010\010\010done \n");
  ROOT_DEV = 0x0101;		// 修改ROOT_DEV 使其指向虚拟盘ramdisk。
}