---
name: "xpeek"
section: "8"
platform: "linux"
package: "jfsutils"
version: "1.0.14-1"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/xpeek"
---

# xpeek(8)

shell-type JFS file system editor

## NAME

xpeek - shell-type JFS file system editor

## SYNOPSIS

```
xpeek <device>
```

## DESCRIPTION

 xpeek is a program which can be used to perform various low-level actions on a JFS formatted partition.  \
  xpeek must be run as root.

## COMMANDS

- **a\[lter\]** *\<block\> \<offset\> \<hex\_string\>*

   replaces the data located at the  *\<offset\>* of *\<block\>* with *\<hex\_string\>*

  *\<block\>* is the block number - given in decimal

  *\<offset\>* is the offset within that block - given in hexadecimal

  *\<hex\_string\>* is an even-numbered string of hexadecimal digits to write to the disk

- **b\[tree\]** *\<block\> \[\<offset\>\]*

   displays one node of the btree located at *\<offset\>* of *\<block\>* and enters a subcommand mode to navigate the btree

  **SUBCOMMANDS:**\
    l =\> visit left sibling\
    m =\> modify current node\
    p =\> visit parent node\
    r =\> visit right sibling\
    \[0-9\] =\> visit the n'th child node\
    x =\> exit subcommand mode

- **cb\[blfsck\]**

   displays the area used by ClearBadBlockList for communication with chkdsk

- **dir\[ectory\]** *\<inode\_number\> \[\<file\_set\>\]*

   displays the directory entries at *\<inode\_number\>* and enters subcommand mode

  *\<inode\_number\>* is the directory's inode - given in decimal

  *\<file\_set\>* currently must be zero

  **SUBCOMMANDS:**\
    m =\> modify entries\
    x =\> exit subcommand mode

- **d\[isplay\]** *\[\<block\> \[\<offset\> \[\<format\> \[\<count\>\]\]\]\]*

  displays *\<count\>* objects located at the *\<offset\>* of *\<block\>* in *\<format\>*

  *\<block\>* is the block number - given in decimal

  *\<offset\>* is the offset within *\<block\>* - given in hexadecimal

  *\<format\>* is one of the following:\
    a =\> ascii\
    b =\> block allocation map\
    d =\> decimal\
    i =\> inode\
    I =\> inode allocation map\
    s =\> superblock\
    x =\> hexadecimal\
    X =\> extent allocation descriptor

  *\<count\>* is the number of objects to display - given in decimal

- **dm\[ap\]**

   displays aggregate disk (block) map

- **dt\[ree\]** *\<inode\_number\> \[\<file\_set\>\]*

   displays root of the directory btree located at *\<inode\_number\>* and enters a subcommand mode to navigate the btree

  *\<inode\_number\>* is the directory's inode - given in decimal

  *\<file\_set\>* currently must be zero

  **SUBCOMMANDS**\
    l =\> visit left sibling\
    m =\> modify current node\
    p =\> visit parent node (not parent directory)\
    r =\> visit right sibling\
    \[0-9\] =\> visit the n'th child node\
    x =\> exit subcommand mode

- **fsckw\[sphdr\]**

   displays the header of the chkdsk workspace in the aggregate

- **h\[elp\]** *\[\<command\>\]*

   displays help for *\<command\>*\
    if no command is given, all possible commands are displayed

- **ia\[g\]** *\[\<IAG\_number\>\] \[a \| s \| \<file\_set\>\]*

   displays IAG information for  *\<IAG\_number\>* and enters subcommand mode

  *\<IAG\_number\>* is given in decimal

  *a* is to use the primary aggregate inode table

  *s* is to use the secondary aggregate inode table

  *\<file\_set\>* currently must be zero

  **SUBCOMMANDS**\
    e =\> display/modify inode extents map\
    m =\> modify IAG\
    p =\> display/modify persistent map\
    w =\> display/modify working map\
    x =\> exit subcommand mode

- **i\[node\]** *\[\<inode\_number\>\] \[a \| s \| \<file\_set\>\]*

   displays inode information for *\<inode\_number\>* and enters subcommand mode

  *\<inode\_number\>* is given in decimal

  *a* is to use the primary aggregate inode table

  *s* is to use the secondary aggregate inode table

  *\<file\_set\>* currently must be zero

  **SUBCOMMANDS**\
    a =\> display/modify inode's ACL\
    m =\> modify inode\
    x =\> exit subcommand mode

- **logs\[uper\]**

   displays the journal log superblock and enters subcommand mode

  **SUBCOMMANDS**\
    m =\> modify journal log superblock\
    x =\> exit subcommand mode

- **q\[uit\]**

   exits xpeek

- **se\[t\]** *\[\<variable\> \<value\>\]*

   set user-defined  *\<variable\>* to *\<value\>*\
    if no arguments are given, displays all set variables

  *\<variable\>* must begin with an alphabetic character

- **su\[perblock\]** *\[p \| s\]*

   displays superblock data

  *p* displays the primary superblock

  *s* displays the secondary superblock

- **s2p\[erblock\]** *\[p \| s\]*

   displays alternate superblock data

  *p* displays the primary superblock

  *s* displays the secondary superblock

- **u\[nset\]** *\<variable\>*

   deletes user-defined  *\<variable\>*

- **xt\[ree\]** *\<inode\_number\> \[\<file\_set\>\]*

   displays root of the non-directory btree located at *\<inode\_number\>* and enters a subcommand mode to navigate the btree

  *\<inode\_number\>* is the directory's inode - given in decimal

  *\<file\_set\>* currently must be zero

  **SUBCOMMANDS**\
    l =\> visit left sibling\
    m =\> modify current node\
    p =\> visit parent node (not parent directory)\
    r =\> visit right sibling\
    \[0-9\] =\> visit the n'th child node\
    x =\> exit subcommand mode

## BUGS

\*insert known bugs here\*

## SEE ALSO

[**fsck.jfs**(8)](/fsck.jfs/8.md)**,** [**extendfs**(8)](/extendfs/8.md)**,** [**logdump**(8)](/logdump/8.md)**,** [**logredo**(8)](/logredo/8.md)**,** [**mkfs.jfs**(8)](/mkfs.jfs/8.md)**,** [**xchkdmp**(8)](/xchkdmp/8.md)

## AUTHORS

```
fsck.jfs is maintained by IBM
(http://oss.software.ibm.com/jfs/).
Manual page by William Braswell, Jr.
```