Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FILEOBJ(1)		    General Commands Manual		    FILEOBJ(1)

NAME
       fileobj - Hex Editor

SYNOPSIS
       fileobj [options]... [paths]...

DESCRIPTION
       fileobj is a portable console hex editor	with vi	interface.  fileobj
       requires	Python 2.6 or above, and runs on Unix-like operating systems
       with ncurses.  fileobj provides basic vi	commands for binary editing.
       Features	include	inserting and replacing	data in	hexadecimal or ascii,
       deleting	data, cut and paste, undo and redo, visual select, multiple
       buffers and windows, partial file loading, raw disk/partition support,
       ptrace based userspace editing, data in C struct	view, etc.

OPTIONS
       --version
	   Print program's version number and exit.

       -h, --help
	   Print this help message and exit.

       -R
	   Use read-only mode.

       -B
	   Use malloc(3) based buffer for regular files, which may put
	   pressure on the system depending on the file	size.  Regular files
	   use mmap(2) based buffer by default,	and relies on mremap(2)	when
	   resizing (i.e. insert or delete bytes) the buffer.  This option is
	   used	when the system	doesn't	support	mremap(2), but need to resize
	   the buffer for regular files.  Linux	kernel has mremap(2), but many
	   of the *BSD do not.

       -d
	   Enable a window to show the buffer offset from offset to
	   offset+length rather	than from from 0 to length, when the buffer is
	   partially loaded.  Using @offset:length or @offset-(offset+length)
	   syntax right	after the path allows partial buffer loading.  See
	   DOCUMENTATION for details of	the syntax.

       -x
	   Enable a window to show the buffer size and current position	in
	   hexadecimal.

       -o _num_
	   Start the program with each buffer given by paths loaded in _num_
	   windows, as long as the terminal has	enough size to store the
	   number of windows specified.

       -O
	   Start the program with each buffer given by paths loaded in
	   different windows, as long as the terminal has enough size to store
	   the number of windows specified.

       --bytes_per_line=_bytes_per_line_
	   Specify number of bytes printed per line.  The program prints
	   _bytes_per_line_ bytes for each line	as long	as the terminal	has
	   enough width	to store bytes.	 Available formats for
	   _bytes_per_line_ are	digits,	"max", "min" and "auto".  If this
	   option isn't	specified, the program assumes "auto" is specified.
	   Using "auto"	sets the value to the maximum 2^N that fits in the
	   terminal width.

       --bytes_per_window=_bytes_per_window_
	   Specify number of bytes printed per window, based on	the current
	   number of bytes per line.  The program prints _bytes_per_window_
	   bytes for each window as long as the	terminal has enough size to
	   store bytes.	 Available formats for _bytes_per_window_ are digits,
	   "even" and "auto".  Specifying "even" doesn't specify the size of
	   window, but makes all windows have the same size.  If this option
	   isn't specified, the	program	assumes	"auto" is specified.  Using
	   "auto" sets the value to the	maximum	available that fits in the
	   terminal size, based	on the current number of bytes per line.

       --terminal_height=_terminal_height_
	   Specify the terminal	height.	 The program uses _terminal_height_
	   lines as long as the	terminal has enough height to store lines.
	   This	option is usually unnecessary as the program is	able to
	   retrieve the	terminal height	by default.

       --terminal_width=_terminal_width_
	   Specify the terminal	width.	The program uses _terminal_width_
	   bytes for each line as long as the terminal has enough width	to
	   store the bytes.  This option is usually unnecessary	as the program
	   is able to retrieve the terminal width by default.

       --fg=_color_
	   Specify foreground color of the terminal.  Available	colors for
	   _color_ are "black",	"blue",	"cyan",	"green", "magenta", "red",
	   "white" and "yellow".  If neither this option nor --bg option is
	   specified, the program assumes "black" is specified.

       --bg=_color_
	   Specify background color of the terminal.  Available	colors for
	   _color_ are "black",	"blue",	"cyan",	"green", "magenta", "red",
	   "white" and "yellow".  If neither this option nor --fg option is
	   specified, the program assumes "white" is specified.

       --verbose_window
	   Use verbose status window format.

       --force
	   Ignore warnings and force the action.

       --command
	   Print the list of available editor commands and exit.

       --sitepkg
	   Print Python's site-package directory being used by the program and
	   exit.

COMMANDS
       See DOCUMENTATION for details of	available editor commands.  Also see
       --command option	in OPTIONS.

FILES
       ~/.fileobj
	   A directory automatically created by	the program.  Some editor
	   commands use	a configuration	file in	this directory.

       ~/.fileobj/history
	   A file contains history of executed editor commands.

       ~/.fileobj/log
	   A file contains information and warning messages logged by the
	   program.

       ~/.fileobj/marks
	   A file contains per-file marks marked by an editor command.

       /usr/share/licenses/fileobj/COPYING
       /usr/share/doc/fileobj/CHANGES
       /usr/share/doc/fileobj/CONTRIBUTORS
       /usr/share/doc/fileobj/PKG-INFO
       /usr/share/doc/fileobj/README.md
	   These files may or may not be installed depending on	the
	   installation	package.

       /usr/local/share/man/man1/fileobj.1.gz or
       /usr/local/share/man/man1/fileobj.1 or
       /usr/share/man/man1/fileobj.1.gz	or
       /usr/share/man/man1/fileobj.1
	   This	manpage.

RESOURCE
       https://sourceforge.net/projects/fileobj/
       https://github.com/kusumi/fileobj/

DOCUMENTATION
       https://github.com/kusumi/fileobj/blob/v0.7/README.md

COPYING
       Copyright (c) 2010-2017,	Tomohiro Kusumi.  Free use of this software is
       granted under the terms of the BSD License (2-clause).

AUTHORS
       Tomohiro	Kusumi <kusumi.tomohiro@gmail.com>

FILEOBJ	0.7.55		       November	3, 2017			    FILEOBJ(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | COMMANDS | FILES | RESOURCE | DOCUMENTATION | COPYING | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=fileobj&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help