highuid.txt: standardize document format

Each text file under Documentation follows a different
format. Some doesn't even have titles!

Change its representation to follow the adopted standard,
using ReST markups for it to be parseable by Sphinx:

- use a markup for the title;
- use :Author: and :Last updated: markups at the beginning with
  authorship info;
- use proper markups for the lists.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
Mauro Carvalho Chehab 2017-05-14 13:51:39 -03:00 committed by Jonathan Corbet
parent ccd8d5577c
commit e45b082d46

View File

@ -1,4 +1,9 @@
Notes on the change from 16-bit UIDs to 32-bit UIDs: ===================================================
Notes on the change from 16-bit UIDs to 32-bit UIDs
===================================================
:Author: Chris Wing <wingc@umich.edu>
:Last updated: January 11, 2000
- kernel code MUST take into account __kernel_uid_t and __kernel_uid32_t - kernel code MUST take into account __kernel_uid_t and __kernel_uid32_t
when communicating between user and kernel space in an ioctl or data when communicating between user and kernel space in an ioctl or data
@ -28,30 +33,34 @@ What's left to be done for 32-bit UIDs on all Linux architectures:
uses the 32-bit UID system calls properly otherwise. uses the 32-bit UID system calls properly otherwise.
This affects at least: This affects at least:
iBCS on Intel
sparc32 emulation on sparc64 - iBCS on Intel
(need to support whatever new 32-bit UID system calls are added to
sparc32) - sparc32 emulation on sparc64
(need to support whatever new 32-bit UID system calls are added to
sparc32)
- Validate that all filesystems behave properly. - Validate that all filesystems behave properly.
At present, 32-bit UIDs _should_ work for: At present, 32-bit UIDs _should_ work for:
ext2
ufs - ext2
isofs - ufs
nfs - isofs
coda - nfs
udf - coda
- udf
Ioctl() fixups have been made for: Ioctl() fixups have been made for:
ncpfs
smbfs - ncpfs
- smbfs
Filesystems with simple fixups to prevent 16-bit UID wraparound: Filesystems with simple fixups to prevent 16-bit UID wraparound:
minix
sysv - minix
qnx4 - sysv
- qnx4
Other filesystems have not been checked yet. Other filesystems have not been checked yet.
@ -69,9 +78,3 @@ What's left to be done for 32-bit UIDs on all Linux architectures:
- make sure that the UID mapping feature of AX25 networking works properly - make sure that the UID mapping feature of AX25 networking works properly
(it should be safe because it's always used a 32-bit integer to (it should be safe because it's always used a 32-bit integer to
communicate between user and kernel) communicate between user and kernel)
Chris Wing
wingc@umich.edu
last updated: January 11, 2000