From: Roger Gammans <roger@computer-surgery.co.uk>
Date: Wed, 4 Oct 2006 11:37:45 +0000 (+0200)
Subject: [PATCH] Document bi_sector and sector_t
X-Git-Url: https://git.stricted.de/?a=commitdiff_plain;h=2c2345c2b4fec30d12e1e1a6ee153a80af101e32;p=GitHub%2Fmt8127%2Fandroid_kernel_alcatel_ttab.git

[PATCH] Document bi_sector and sector_t

Signed-Off-By: Roger Gammans <rgammans@computer-surgery.co.uk>
Signed-off-by: Jens Axboe <jens.axboe@oracle.com>
---

diff --git a/include/linux/bio.h b/include/linux/bio.h
index 711c321a7011..092dbd0e7658 100644
--- a/include/linux/bio.h
+++ b/include/linux/bio.h
@@ -70,7 +70,8 @@ typedef void (bio_destructor_t) (struct bio *);
  * stacking drivers)
  */
 struct bio {
-	sector_t		bi_sector;
+	sector_t		bi_sector;	/* device address in 512 byte
+						   sectors */
 	struct bio		*bi_next;	/* request queue link */
 	struct block_device	*bi_bdev;
 	unsigned long		bi_flags;	/* status, command, etc */
diff --git a/include/linux/types.h b/include/linux/types.h
index 406d4ae57631..750f085fa564 100644
--- a/include/linux/types.h
+++ b/include/linux/types.h
@@ -129,8 +129,12 @@ typedef		__s64		int64_t;
 /* this is a special 64bit data type that is 8-byte aligned */
 #define aligned_u64 unsigned long long __attribute__((aligned(8)))
 
-/*
+/**
  * The type used for indexing onto a disc or disc partition.
+ *
+ * Linux always considers sectors to be 512 bytes long independently
+ * of the devices real block size.
+ *
  * If required, asm/types.h can override it and define
  * HAVE_SECTOR_T
  */