Re: [PATCH v6,RESEND] Translate debugfs.txt into Chinese and link it to the index.
From: Alex Shi
Date: Wed Apr 08 2020 - 06:57:32 EST
Reviewed-by: Alex Shi <alex.shi@xxxxxxxxxxxxxxxxx>
Thanks!
Alex
å 2020/4/8 äå10:15, Chucheng Luo åé:
> Translate Documentation/filesystems/debugfs.txt into Chinese.
>
> Signed-off-by: Chucheng Luo <luochucheng@xxxxxxxx>
> ---
> Changelog:
> v6:
> - keep each line less than 80 chars, but also keep each line full
> - remove redundant '=' in caption and all other subheadings
> - send the patch with 'charset=UTF-8'
> ---
> .../zh_CN/filesystems/debugfs.rst | 221 ++++++++++++++++++
> .../translations/zh_CN/filesystems/index.rst | 21 ++
> Documentation/translations/zh_CN/index.rst | 2 +
> 3 files changed, 244 insertions(+)
> create mode 100644 Documentation/translations/zh_CN/filesystems/debugfs.rst
> create mode 100644 Documentation/translations/zh_CN/filesystems/index.rst
>
> diff --git a/Documentation/translations/zh_CN/filesystems/debugfs.rst b/Documentation/translations/zh_CN/filesystems/debugfs.rst
> new file mode 100644
> index 000000000000..f8a28793c277
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/filesystems/debugfs.rst
> @@ -0,0 +1,221 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :ref:`Documentation/filesystems/debugfs.txt <debugfs_index>`
> +
> +=======
> +Debugfs
> +=======
> +
> +èè
> +::
> +
> + äæççæèï çææ Chucheng Luo <luochucheng@xxxxxxxx>
> + äæççèèï çææ Chucheng Luo <luochucheng@xxxxxxxx>
> + äæçæèè: çææ Chucheng Luo <luochucheng@xxxxxxxx>
> +
> +
> +
> +çæææ2020 çææ <luochucheng@xxxxxxxx>
> +
> +
> +Debugfsæåæååäååçæçéèåäæççåææãä/procäåïprocåæäèç
> +äæãääåsysfs,åæäæçâæäæäääåâçèåãdebugfsææææèå,åå
> +äååäåèéæçääæèçäääæãdebugfsæäççääèçäçåçABIæåã
> +äçèäèïdebugfsååæäçæåææääçæãäæ[1]åéæååäææéä
> +çåãåäædebugfsæåïäæåææéèèèèè,ååéäææåäåã
> +
> +
> +Debugfséåäçääåäåè::
> +
> + mount -t debugfs none /sys/kernel/debug
> +
> +ïæçæç/etc/fstabèïã
> +debugfsæçåéèäåçrootçæèéãèææåæäæçèéïèäçâ uidâïâ gidâ
> +åâ modeâæèééãèææïdebugfs APIäæçGPLåèåååæåã
> +
> +äçdebugfsçäçååå<linux/debugfs.h>ãçåïéåæååèåääçåæäå
> +äçdebugfsæä::
> +
> + struct dentry *debugfs_create_dir(const char *name, struct dentry *parent);
> +
> +åææåïæèçååæåçççåäååääåänameççåãåæparentåæäçï
> +åäådebugfsæçåäååãååçåæåæïèååæääæådentryçæäçæéã
> +èdentryçæäçæéåçäåçåäååæäïäåæåååæçååïãERR_PTR
> +ï-ERRORïèååèæåéãåæèåERR_PTRï-ENODEVïïåèæåææåæædebugfs
> +ææçæåäæåçïåääèåæéääèäçã
> +
> +ådebugfsçåäååæäçæéçæææ::
> +
> + struct dentry *debugfs_create_file(const char *name, umode_t mode,
> + struct dentry *parent, void *data,
> + const struct file_operations *fops);
> +
> +åèéïnameæèååçæäçåçïmodeæèäèéæäååæçæéïparentæå
> +åèäåæäççåïdataååååäççinodeçæäçi_privateåæäïèfopsæ
> +äçæäæäåæïèäåæäåçæäæäçåäèäãèåïreadïïå/æ
> +writeïïæäåæäïåäåäææéèåæååãåæçïèåååææåååæä
> +çdentryæéïéèæèåERR_PTRï-ERRORïïççäæædebugfsæèååäERR_PTR
> +ï-ENODEVïãååääååååçæäïåääçääåæäæ::
> +
> + struct dentry *debugfs_create_file_size(const char *name, umode_t mode,
> + struct dentry *parent, void *data,
> + const struct file_operations *fops,
> + loff_t file_size);
> +
> +file_sizeæååæäååãåäåæèåædebugfs_create_fileççåã
> +
> +åèåæåäïæåèèååååäçæäæä;åäääçåçæå,debugfsäçæä
> +äèååååæãåååäææåçæäåääçäääääéåå::
> +
> + void debugfs_create_u8(const char *name, umode_t mode,
> + struct dentry *parent, u8 *value);
> + void debugfs_create_u16(const char *name, umode_t mode,
> + struct dentry *parent, u16 *value);
> + struct dentry *debugfs_create_u32(const char *name, umode_t mode,
> + struct dentry *parent, u32 *value);
> + void debugfs_create_u64(const char *name, umode_t mode,
> + struct dentry *parent, u64 *value);
> +
> +èäæäææèååååçååãåææäæääææååïåéææéèèçmode
> +åæäãèäæääçåäåèåèçïåæéèäçååèåïåääçääåæ
> +æä::
> +
> + void debugfs_create_x8(const char *name, umode_t mode,
> + struct dentry *parent, u8 *value);
> + void debugfs_create_x16(const char *name, umode_t mode,
> + struct dentry *parent, u16 *value);
> + void debugfs_create_x32(const char *name, umode_t mode,
> + struct dentry *parent, u32 *value);
> + void debugfs_create_x64(const char *name, umode_t mode,
> + struct dentry *parent, u64 *value);
> +
> +èäåèåæåååäåçéåååçååçæåææçãæäææçååäåçææä
> +æäåçååïèæääæåååæäåæãåèççææåäåääçääåæ::
> +
> + void debugfs_create_size_t(const char *name, umode_t mode,
> + struct dentry *parent, size_t *value);
> +
> +äåææïæåæåååäädebugfsæäæèççåäsize_tçåéã
> +
> +åæåïäæååæçåéæååéçåæïååäåèååååèåèçåä::
> +
> + struct dentry *debugfs_create_ulong(const char *name, umode_t mode,
> + struct dentry *parent,
> + unsigned long *value);
> + void debugfs_create_xul(const char *name, umode_t mode,
> + struct dentry *parent, unsigned long *value);
> +
> +ååååäéèääæåæçådebugfsä::
> +
> + struct dentry *debugfs_create_bool(const char *name, umode_t mode,
> + struct dentry *parent, bool *value);
> +
> +
> +èåçææäåäçYïåäééåïæNïåèæèçååçæåïååæåååæåå
> +åæ1æ0ãääåäèååèåçã
> +
> +åæïatomic_tçåçåäåäæçådebugfsä::
> +
> + void debugfs_create_atomic_t(const char *name, umode_t mode,
> + struct dentry *parent, atomic_t *value)
> +
> +èåææäåèåatomic_tåïååææäåèçatomic_tåã
> +
> +åääéææéèääçæäååæååäääæäèåææå::
> +
> + struct debugfs_blob_wrapper {
> + void *data;
> + unsigned long size;
> + };
> +
> + struct dentry *debugfs_create_blob(const char *name, umode_t mode,
> + struct dentry *parent,
> + struct debugfs_blob_wrapper *blob);
> +
> +èåææäåèåçæéæådebugfs_blob_wrapperçæäçææãääéåäçâblobsâ
> +äääçèååèïéæïæååææççåææãèäåæåçäååäèåäæïä
> +ääåäçäææäääçèæåãèææïäçdebugfs_create_blobïïåäååç
> +æææäæåèçã
> +
> +åææèèåääååååïåååèçäçåäèäåïäæèæçèèäçååää
> +åäçäãDebugfsæäääåæïääçäååäåååæäïåääæääåååå
> +æåääéåæää::
> +
> + struct debugfs_reg32 {
> + char *name;
> + unsigned long offset;
> + };
> +
> + struct debugfs_regset32 {
> + struct debugfs_reg32 *regs;
> + int nregs;
> + void __iomem *base;
> + };
> +
> + struct dentry *debugfs_create_regset32(const char *name, umode_t mode,
> + struct dentry *parent,
> + struct debugfs_regset32 *regset);
> +
> + void debugfs_print_regs32(struct seq_file *s, struct debugfs_reg32 *regs,
> + int nregs, void __iomem *base, char *prefix);
> +
> +âbaseâåæåèä0ïäæåèéèäç__stringifyæåreg32æçïåéäæèåååå
> +åçïåïæåååååååäçåèåçéã
> +
> +åæèådebugfsäèåu32æçïåääçääåæååæä::
> +
> + void debugfs_create_u32_array(const char *name, umode_t mode,
> + struct dentry *parent,
> + u32 *array, u32 elements);
> +
> +âarrayâåææäææïèâelementsâåæäæçäåççæéãææïæçåååïæç
> +ååææææã
> +
> +æääåææååäèåçåçseq_file::
> +
> + struct dentry *debugfs_create_devm_seqfile(struct device *dev,
> + const char *name,
> + struct dentry *parent,
> + int (*read_fn)(struct seq_file *s,
> + void *data));
> +
> +âdevâåææäædebugfsæäçåçèåïåäâread_fnâæääåææéïèäåæå
> +æåseq_fileååçæåèåèã
> +
> +èæääåäçéåçåçåæ::
> +
> + struct dentry *debugfs_rename(struct dentry *old_dir,
> + struct dentry *old_dentry,
> + struct dentry *new_dir,
> + const char *new_name);
> +
> + struct dentry *debugfs_create_symlink(const char *name,
> + struct dentry *parent,
> + const char *target);
> +
> +èçdebugfs_rename()åäçæçdebugfsæäéååïåèåæåæçåã new_name
> +åæèçäåäèååïèååäold_dentryïåäååææçäæãåääç
> +debugfs_create_symlinkïïååçåéæã
> +
> +æædebugfsçæåéèèçäääæï
> +
> +debugfsääèåæéååäååçääçåãåæääæååäæååédebugfsçåç
> +æåäåèæåïçæåäéçååéæéïäèåèççäçåãåæïæædebugfs
> +çæ-èåæéäåäääæåæåççæ-åéåæååèçæååååéåæååç
> +æææäåçåãääæäåäéèääæååé::
> +
> + void debugfs_remove(struct dentry *dentry);
> +
> +dentryååääNULLæéèåïåèçæåäïääæääæäèåéã
> +
> +åääåïåæååèäçdebugfsæéèèåääååçæädentryæéïääæåææ
> +æäéåäèæçæãäæïçådebugfsçæèèçääåæéåæéäåååçæä::
> +
> + void debugfs_remove_recursive(struct dentry *dentry);
> +
> +åæåååéåçåçdentryäéçääåæïåèçåäçæäåæçæåäèåéã
> +
> +æéï
> +[1] http://lwn.net/Articles/309298/
> diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
> new file mode 100644
> index 000000000000..c2e9e6224931
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/filesystems/index.rst
> @@ -0,0 +1,21 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +======================
> +Linux åæäçæäçç
> +======================
> +
> +èääåæçæååæäååäæäåäLinux èææäçç(VFS)ååäåäçåæ
> +äæãäåVFSääççæäççãçåäæïæäæäääääæã
> +
> +
> +
> +
> +æäçç
> +========
> +
> +åäæäççåççææ.
> +
> +.. toctree::
> + :maxdepth: 2
> +
> + debugfs
> diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst
> index d3165535ec9e..770f886d081c 100644
> --- a/Documentation/translations/zh_CN/index.rst
> +++ b/Documentation/translations/zh_CN/index.rst
> @@ -1,3 +1,4 @@
> +.. SPDX-License-Identifier: GPL-2.0
> .. raw:: latex
>
> \renewcommand\thesection*
> @@ -14,6 +15,7 @@
> :maxdepth: 2
>
> process/index
> + filesystems/index
>
> çååèæ
> ----------
>