| .\" PS3 flash memory utility |
| .\" |
| .\" Copyright (C) 2008 Sony Computer Entertainment Inc. |
| .\" Copyright 2008 Sony Corp. |
| .\" |
| .\" This program is free software; you can redistribute it and/or modify |
| .\" it under the terms of the GNU General Public License as published by |
| .\" the Free Software Foundation; version 2 of the License. |
| .\" |
| .\" This program is distributed in the hope that it will be useful, |
| .\" but WITHOUT ANY WARRANTY; without even the implied warranty of |
| .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| .\" GNU General Public License for more details. |
| .\" |
| .\" You should have received a copy of the GNU General Public License |
| .\" along with this program; if not, write to the Free Software |
| .\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| .\" |
| .\" Maintainer's Notes: |
| .\" * For syntax help see the man pages for 'mdoc' and 'mdoc.samples'. |
| .\" * To check syntax use this: |
| .\" 'groff -C -mtty-char -Tutf8 -man ps3-flash-util.8'. |
| .\" * To check format use this: 'less ps3-flash-util.8'. |
| .\" |
| .Dd "" |
| .Dt ps3-flash-util 8 |
| .Os |
| .\" |
| .Sh NAME |
| .\" ==== |
| .Nm ps3-flash-util |
| .Nd PS3 flash memory utility |
| .\" |
| .Sh SYNOPSIS |
| .\" ======== |
| .Nm |
| .Op Fl d, -device Ar flash-dev |
| .Op Fl s, -show-settings |
| .Op Fl w, -write-image Ar image-file |
| .Op Fl g, -set-game-os | Fl o, -set-other-os |
| .Op Fl r, -set-raw | Fl z, -set-gzip |
| .Op Fl t, -game-time |
| .Op Fl T, -db-test |
| .Op Fl F, -db-format |
| .Op Fl P, -db-print Ar owner Ar key |
| .Op Fl D, -db-write-dword Ar owner Ar key Ar dword |
| .Op Fl W, -db-write-word Ar owner Ar key Ar word |
| .Op Fl H, -db-write-half Ar owner Ar key Ar half |
| .Op Fl R, -db-remove Ar owner Ar key |
| .Op Fl L, -db-list-known |
| .Op Fl h, -help |
| .Op Fl v, -verbose |
| .Op Fl V, -version |
| .\" |
| .Sh DESCRIPTION |
| .\" =========== |
| The ps3-flash-util utility is used to operate on the system flash ROM |
| of the PS3 game console. |
| .\" |
| .Sh OPTIONS |
| .\" ======= |
| .Bl -tag -width indent |
| .\" |
| .It Fl d, -device Ar flash-dev |
| Use the flash device node |
| .Ar flash-dev |
| (default=/dev/ps3flash). |
| .\" |
| .It Fl s, -show-settings |
| Show the current flash settings (non-destructive). |
| .\" |
| .It Fl w, -write-image Ar image-file |
| Write the Other OS image |
| .Ar image-file |
| to flash memory and update the OS area header with information for the |
| new image. This is the option to use to write a new bootloader image |
| to flash memory. Use '-' for data on stdin. |
| .\" |
| .It Fl g, -set-game-os |
| Set the system boot flag to Game OS. |
| .\" |
| .It Fl o, -set-other-os |
| Set the system boot flag to Other OS. |
| .\" |
| .It Fl r, -set-raw |
| Set the Other OS image compression flag to raw (not compressed). |
| .\" |
| .It Fl z, -set-gzip |
| Set the Other OS image compression flag to gzip compressed. |
| .\" |
| .It Fl t, -game-time |
| Print the Game OS RTC diff value. |
| .\" |
| .It Fl T, -db-test |
| Test for the existence of an Other OS database in flash memory. |
| Exits with a zero status if a database is found. |
| .\" |
| .It Fl F, -db-format |
| Format (write) an empty Other OS database to flash memory. |
| Any existing data in the flash memory will be lost. |
| .\" |
| .It Fl P, -db-print Ar owner Ar key |
| Print owner:key database entries. A negative one (-1) value for owner or key |
| can be used as a wildcard to match any owner or key. |
| .\" |
| .It Fl D, -db-write-dword Ar owner Ar key Ar dword |
| Add or update a 64 bit owner:key database entry. The |
| .Ar dword |
| argument supports input matching the scanf "%Li" format specification. |
| .\" |
| .It Fl W, -db-write-word Ar owner Ar key Ar word |
| Add or update a 32 bit owner:key database entry. The |
| .Ar word |
| argument supports input matching the scanf "%Li" format specification. |
| .\" |
| .It Fl H, -db-write-half Ar owner Ar key Ar half |
| Add or update a 16 bit owner:key database entry. The |
| .Ar half |
| argument supports input matching the scanf "%Li" format specification. |
| .\" |
| .It Fl R, -db-remove Ar owner Ar key |
| Remove an owner:key entry from the database. A negative one (-1) value for owner or key |
| can be used as a wildcard to match any owner or key. |
| .\" |
| .It Fl L, -db-list-known |
| List known database owners and keys. |
| .\" |
| .It Fl h, -help |
| Print a help message. |
| .\" |
| .It Fl v, -verbose |
| Program verbosity level. The level is additive. |
| .\" |
| .It Fl V, -version |
| Display the program version number. |
| .El |
| .\" |
| .Sh RETURN VALUE |
| .\" ============ |
| Returns 0 on success, 1 on error. |
| .Sh SEE ALSO |
| .\" ======== |
| .Xr ps3-boot-game-os 8 , Xr ps3-dump-bootloader 8 |
| .\" |
| .Sh AUTHOR |
| .\" ====== |
| Written by Masato Noguchi and Geoff Levand. |
| .\" |
| .Sh REPORTING BUGS |
| .\" ============== |
| Send bug reports to @PACKAGE_BUGREPORT@. |