Ashula.info opera:inis

Adrs

Mon, 12 May 2008 16:30:17 +0900

Adrs

meta-author: t.ashula meta-creation_date: 2007-07-15T19:25:09+09:00

Opera のブックマーク，コンタクト，メモ，Widget，<!–音楽–>あたりの管理ファイルの adr 形式について．

注意

この文書は，WindowsXPにWindows版の Opera9をインストールしたときの情報に基づいて作成してます．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

ここで言う adr ファイルとは，Opera のブックマークやコンタクトを管理するファイル群で具体的には，ブックマーク( opera6.adr ), コンタクト( contacts.adr )，メモ ( notes.adr )，Widget の管理ファイル( widgets.adr ) といった，拡張子 adr を持つファイルを言う．

「ユーザごとの設定を使う」でインストールすると，Opera Direcotry( 通常，%APPDATA%\Opera\Opera\profile)以下に作られる(%APPDATA%は，通常Documents and Settings\user_name\Application Data．エクスプローラの「ツール→フォルダオプション→表示→全てのファイルとフォルダを表示する」が設定されていないと見ることは出来ない)．正確な場所は opera:config#UserPrefs|OperaDirectoryの値を参照のこと．

ここにまとめた情報は主に，Files Used by Operaを基にしている．ほかの資料は参考文献を参照．

構造

データ構造

adrファイルでの基本的なデータ構造は以下のようになっている．


#<ITEM>
<U+09><KEY>=<VALUE>
<U+09><KEY>=<VALUE>
<U+09><KEY>=<VALUE>
:
-

<ITEM> には #FOLDER，#SEPARATOR，#URL，#CONTACT，#NOTE，#WIDGGETがある．このうち#FOLDER，#SEPARATOR，は全ファイルで共通に使われるが，それ以外のはそれぞれ順に，ブックマーク，コンタクト，メモ，ウィジェットの各ファイルでのみ用いられる．

<KEY>は，<ITEM>によって必須なものや任意のものが有るが，全ての<ITEM>に対して，IDだけは共通してついている．このIDの値は全 adr ファイルで通し番号となっていて，基本的にはそのアイテムの作られた順に振られるようだが，Operaの終了時に opera6.adr, contacts.adr,notes.adr, widgets.adr の順に番号が振りなおされることがある．

<VALUE> 中で改行する場合，U+02 U+02 として保存される．

最後の -と改行でデータ構造の終端を表す．

#FOLDER には，<KEY>=<VALUE>の組だけでなく，#FOLDER自身を含めて全ての#<ITEM>を格納することが出来る．その場合は次のようになる．


#<FOLDER>
<U+09><KEY>=<VALUE>
<U+09><KEY>=<VALUE>
<U+09><KEY>=<VALUE>
:

#<FOLDER>
<U+09><KEY>=<VALUE>
<U+09><KEY>=<VALUE>
<U+09><KEY>=<VALUE>
:

#<ITEM>
<U+09><KEY>=<VALUE>
<U+09><KEY>=<VALUE>
<U+09><KEY>=<VALUE>
:
-

-

-

ファイル構造

ファイルの先頭は以下の形式になる．

Opera Hotlist version 2.0
Options: encoding = utf8, version=3

この後，各ファイルでの <ITEM>に基づいたツリー構造が繰り返される．

ファイルの最後には，ゴミ箱用の#FOLDERがある．

このフォーマットを採用しているファイル

このフォーマットを採用しているファイルは以下のファイルです．それぞれのファイルでの <KEY>=<VALUE> の値の意味はそれぞれのファイルのページにて．

参考文献

Off: Files Used by Opera, http://www.opera.com/docs/fileformats/ , opera.com
Off_jp: Opera for Windows にて使用するファイルについて, http://jp.opera.com/docs/operafiles/ , jp.opera.com
O4FE: Opera4 File Explorer, http://users.westelcom.com/jsegur/O4FE.HTM , Josef W. Segur

更新履歴

2007/12/06 : widgets.adr へのリンクが間違っていたので修正．Thanks id:amatanoyo
2007/07/15 : 初版．

Binaries

Sun, 22 Jun 2008 22:16:09 +0900

Binaries

Opera のキャッシュや cookie を管理するファイル群 dcache4.url, vlink4.dat, download.dat. cookies4.datについての解析．

meta-creation_date: 2006-10-12T23:30:32+09:00

注意

この文書は，WindowsXPにWindows版の Opera9をインストールしたときの情報に基づいて作成してます．別のOS，別のバージョンの解析状況は追々．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

ここで言う binary ファイルとは，Opera のキャッシュや cookie を管理するファイル群で具体的には，キャッシュのインデックスファイル( dcache4.url ), 訪問済みリンクのファイル( vlink4.dat )，ダウンロードレスキューファイル ( download.dat )，cookie の管理ファイル( cookies4.dat ) のことです．

「ユーザごとの設定を使う」でインストールすると，通常，%APPDATA%\Opera\%OperaVersion%\profile以下に作られる (%APPDATA%は，通常Documents and Settings\user_name\Application Data．エクスプローラの「ツール→フォルダオプション→表示→全てのファイルとフォルダを表示する」が設定されていないと見ることは出来ない)．正確な場所は opera:config#UserPrefs|OperaDirectoryの値を参照のこと．

dcache4.url だけは，そこのcache4フォルダの中に作られる．正確な場所は opera:config#UserPrefs|CacheDirectory4の値を参照のこと．

ここにまとめた情報は主に，Opera File Formatsの公式の解説を基に作られています．ほかの資料は参考文献を参照．

構造

使われる数値は基本的に符号なしのビッグエンディアンで格納される．データレコード内の数値も，ビッグエンディアンだが符号が付くこともある．

データ構造

バイナリファイルでの基本的なデータ構造はレコードと呼ばれる．レコードの構造は以下のようになっている．

struct record
{
  // application specific tag to identify content type
  tag_id_type tag_id;
  // length of payload
  payload_length_type length;
  // Payload/content of the record
  bytepayload[ length ];
};

tag_id_type というのはヘッダのidtag_lengthによって決まる型で，file version が 0x 0000 1000のファイルにおいては，1バイトの符号なし整数値であり，同様にpayload_length_type というのはヘッダのlength_lengthによって決まる型で，file version が 0x 0000 1000のファイルにおいては，2byteの符号なし整数値となる．

bytepayloadは，tag_idの値によって中身の解釈が変わるレコードのデータそのもので length バイトにわたって続く．

ペイロードにレコードが入ることもある

フラグレコード

レコードには，2種類あって，ひとつは，上に書いたような，ペイロードのあるデータレコードで，もうひとつはフラグレコードと呼ばれ，length が 0 でペイロードがないレコードである．

フラグレコードかどうかは tag_id の値で決められていて， tag_id の MSBが立っているかどうかでフラグを判断する．MSBが立っているとき，その tag_id が意味するフラグ = true となり，そうでないときは false となる．

ファイル構造

ファイルの先頭は以下の形式になる．

    +--------+--------+--------+--------+
    |   file version number (32bit)     |
    +--------+--------+--------+--------+
    |   app. version number (32bit)     |
    +--------+--------+--------+--------+
    |   idtag_length  |  length_length  |
    +--------+--------+--------+--------+

file version number

ファイル形式のバージョンをあらわす 32bit の値．現行のフォーマットでは 0x 0000 1000. このうち，上位20bitがメジャーバージョン，下位12bitがマイナーバージョンを表す．

古いソフトがファイルをうまく読めなくなるほどに形式が変わったときにはメジャーバージョンが変わる(？)．ソフトウェアが読めるメジャーバージョンと違うバージョンなら読んではいけない． Changes in the minor version must not be used if the file format is changed in such a manner that older versions of the software cannot read the file successfully. If the major version number is newer (or older) than the application can read, it must not read the file.

app. version number

扱うファイルやソフトで解釈される値．32bit．

idtag_length

レコードでの tag_id が何バイトで表されるかを示す16bitの値．今のところ 0x0001

length_length

レコードでの長さのフィールドが何バイトで表されるかを示す16bitの値．今のところ0x0002

idtag_lengthlength_lengthなどの整数値のサイズはメジャーバージョンに対して固定とされている．

この96~~128~~bitのヘッダの後に，レコードがぞろぞろと書かれることになる．

このフォーマットを採用しているファイル

このフォーマットを採用しているファイルは以下のファイルです．それぞれのファイルでの tag_id の値の意味やレコードの構成などはそれぞれのファイルのページに分けてあります．

参考文献

Off: Opera File Formats, http://www.opera.com/docs/fileformats/ , opera.com
Off_jp: Opera のファイル形式, http://jp.opera.com/docs/fileformats/ , jp.opera.com
unofficial: Opera File Formats(私家訳), http://ashula.info/neta/opera/inis/OperaFileFormats-jp.html , t.ashula
O4FE: Opera4 File Explorer, http://users.westelcom.com/jsegur/O4FE.HTM , Josef W. Segur

更新履歴

2006/10/12 : 初版
2007/06/14 : ヘッダのビット数の間違いを修正．(128 bit から 96 bit に)

bookmarks.ini

Wed, 03 Mar 2010 01:22:30 +0900

bookmarks.ini

Opera 10.50 pre-alpha から，Post-beta fixes で使われていたブックマークファイル bookmarks.ini についての解説

Opera 10.10 まで使われていた Opera6.adr から一時的に変更になったが，また戻った．

注意

この文書は，Opera 10.50 β ( build 3248 ) の情報に基づいて作成してます．別のOS，別のバージョンの解析状況は追々．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，Profileか，t.ashulaまで

説明

bookmarks.ini ( Opera 10.10以前では Opera6.adr ) は，operaにおけるブックマーク(お気に入り)の情報を記載したファイル．

「ユーザごとの設定を使う」でインストールすると，通常 %APPDATA%\Opera\Opera\profile に作られる．ただし2つ目の Opera ディレクトリは，C:\Program Files\Opera 10.50 にインストールした場合 Opera 10.50 というようにインストールしたディレクトリ名と同じ名前になる．

構造

ファイルは，ヘッダと，本体からなる．文字コードはデフォルトでutf-8が使われる．

数行のヘッダの後，フォルダと個々のブックマークを表す構造がブックマークの量だけ繰り返される．

ヘッダ

先頭は，他の ini ファイルと同様の書式の Opera Preferences version 情報が入る．

その後，ファイルのエンコード情報と，何かのversionが入る．改変が可能かどうかは不明．

ex.

Opera Preferences version
; Do not edit this file while Opera is running
; This file is stored in UTF-8 encoding

本体

本体は，0 番から始まる通し番号のついた Bookmark X セクションからなる．

旧 ADR 形式と異なり，フォルダかブックマークかに関係なく通し番号がつけられ，セパレータはフォルダの一形態として扱われる．

ブックマーク

ブックマークのセクションの構成は以下の通り．

Ini ファイルの制約から，任意の文字列値を取りうる属性値では，改行が %0D%0A に，= が %3D に変換されて保存される．

`ブックマークのセクションの属性一覧`
属性名	とり得る値	属性の種類	備考
URL	URL	必須	Bookmarklet などもここに
Title	対象ページのタイトル	任意
Description	文字列	任意	Operaでアイテムのプロパティを編集したときのdescriptionの文字列．改行は，%0D%0A に変換されて保存される．
Shortname	文字列	任意	Operaでブックマークのプロパティを編集したときのnicknameに対応する文字列．
Created	時刻 ( W3C DTF )	強制	ブックマークが作られた時刻の W3CDTF 文字列．タイムゾーンはUTC
Visited	時刻 ( W3C DTF )	半強制	ブックマークの URL にアクセスした時刻の W3CDTF 文字列．タイムゾーンはUTC．訪れてない URL や，個人情報の削除で訪問日時を消した場合はつかない．
Favicon file	変形 Base64 エンコードのアイコン画像ファイル	任意	Favicon ファイルそのものを Base64 でエンコードした値．通常の Base64 で詰め物に使われる = が %3D にエンコードされている．
Personalbar pos	整数値	任意	パーソナルバー上での表示順を表す数値
Panel pos	整数値	任意	パネル中での表示順を表す数値．
Small screen	1	任意	パネル内でSmallScreenモードで表示するかどうかを指定する．
Active	1	任意	選択中のとき1
UUID	GUID	強制	ブックマークを区別するための GUID 値．同じアドレスのブックマークでも異なる値が設定される．
Parent folder	GUID	半強制	親フォルダの UUID 値．親フォルダを持たない場合，付かない．

ブックマークの例

[Bookmark 426]
URL=http://web-sniffer.net/
Title=WebSnif
Favicon file=iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAA7ElEQVR42sWRPQoCMRCF91baWIpgYaliaaFiIXgGC1nQUjyCWK5YLlhbbCHY3MKQUPkDfvCrFlZUMTikUwy882bJDDmYb9RUJRQpN8AkvPFhuHI1mZD2xh3ZbLtyLu3wJwicLB5mDnx7ttrycSlzoVKY6WfdG0V5ZcD4BkAigC4EY3AigDoG10RXeMQgeE0D5HcgBYgrR9iA5eAYC7N0DnJKpnHOgRINjnO7BYAAhQDOGAswLCR7vum06IcwG4XKyqMgZWCGe3U0uEHP19RnjUFOILoAI0l09gFFfA4mrtIBxXrEH+ET/BzwBV0tx8HF8QPUAAAAASUVORK5CYII%3D
Created=2008-03-19T15:08:12Z
Visited=1261543770
Panel pos=12
UUID=20942ba7-9ed7-3144-8afb-c6a12469e45a
Parent folder=94fbcddb-3a94-7942-8ecc-36542f4b2ea7

フォルダ

フォルダには Folder type=Normal が設定され，URL などいくつかの項目がない事を除いてブックマークのセクションとほぼ同等．

フォルダの構成は以下の通り．

`フォルダのセクションの属性一覧`
属性名	とり得る値	属性の種類	備考
Folder type	Normal	強制	通常フォルダを表す
Title	文字列	任意	フォルダの名前
Description	文字列	任意	フォルダの説明．改行などのエスケープはブックマークのセクションと同様．
Shortname	文字列	任意	フォルダのニックネーム．
Created	時刻 ( W3C DTF )	強制	フォルダが作られた時刻の W3CDTF 文字列．タイムゾーンは UTC
Parent folder	GUID	半強制	親フォルダの UUID 値．親フォルダを持たない場合，付かない．
Personalbar pos	整数値	任意	パーソナルバー上での表示順を表す数値
Active	1	任意	選択中のとき1
UUID	GUID	強制	フォルダを区別するための GUID 値．同じ名前のフォルダでも異なる値が設定される．

フォルダの例

[Bookmark 425]
Title=www tech
Created=2010-02-09T03:12:10Z
UUID=94fbcddb-3a94-7942-8ecc-36542f4b2ea7
Folder type=Normal
Parent folder=9c5853a4-c60a-f749-9412-7f09b0f44cb5

ゴミ箱

ゴミ箱は Folder type=Trash が設定され，Deletable=0 が設定される．

`ゴミ箱のセクションの属性一覧`
属性名	とり得る値	属性の種類	備考
Title	文字列	強制	「ゴミ箱」の名前
Active	1	任意	ゴミ箱を選択してると 1
Deletable	0	強制	ゴミ箱自身は消せない
Folder type	Trash	強制	ゴミ箱を表す
Created	時刻 ( W3C DTF )	強制	フォルダが作られた時刻の W3CDTF 文字列．タイムゾーンは UTC
UUID	GUID	強制	フォルダを区別するための GUID 値．同じ名前のフォルダでも異なる値が設定される．

ゴミ箱の例

[Bookmark 1056]
Title=Trash
Created=2010-02-11T13:18:30Z
Active=1
Deletable=0
UUID=14c645a5-b8a3-470f-b3b5-2cc32c97e2b8
Folder type=Trash

セパレータ

セパレータは Folder type=Separator が設定され，Created, UUID, Parent folder のみが設定される．

`セパレータのセクションの属性一覧`
属性名	とり得る値	属性の種類	備考
Folder type	Separator	強制	セパレータを表す
Created	時刻 ( W3C DTF )	強制	フォルダが作られた時刻の W3CDTF 文字列．タイムゾーンは UTC
Parent folder	GUID	半強制	親フォルダの UUID 値．親フォルダを持たない場合，付かない．
UUID	GUID	強制	フォルダを区別するための GUID 値．同じ名前のフォルダでも異なる値が設定される．

セパレータの例

 [Bookmark 1056]
 Created=2010-02-15T10:57:51Z
 UUID=cd0875cf-a0d1-4f42-a57b-e7c17cc915e5
 Folder type=Separator
 Parent folder=744810f4-df79-4245-b3d0-2fd6329a5fd8

カスタマイズ

上記の情報で弄れるけども，今のところ， Opera の bookmark から編集するほかない．ブックマーク管理を開くボタン

更新履歴

2010/03/02 : 10.50 で adr 形式に戻ったので修正
2010/02/17 : キャプションがすべてフォルダになってたのを修正
2010/02/15 : 初版

contacts.adr

Mon, 12 May 2008 16:33:04 +0900

contacts.adr

meta-author: t.ashula meta-creation_date: 2007-07-15T16:58:45+09:00

Opera のアドレス帳管理ファイル contacts.adr の解析．

注意

この文書は，WindowsXPにWindows版の Opera 9.22の情報に基づいて作成してます．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

contacts.adrは，Opera のアドレス帳(コンタクト;contacts)を管理するためのファイル．

「ユーザごとの設定を使う」でインストールすると，Opera Directory(通常，%APPDATA%\Opera\Opera\profile)以下に作られる(%APPDATA%は，通常Documents and Settings\user_name\Application Data)．

基本的な構造は，Adrs参照．ITEMとして #CONTACT が用いられる．

構造

contacts.adr ファイルは，ヘッダと，本体からなる．文字コードはデフォルトでUTF-8Nが使われる．

数行のヘッダの後，フォルダと個々のコンタクトを表す構造がメモの量だけ繰り返される．

ヘッダ

先頭は，Hotlist書式のversion情報が入る．

その後，ファイルのエンコード情報と，何かのversionが入る．改変が可能かどうかは不明．

Opera Hotlist version 2.0
Options: encoding = utf8, version=3

本体

本体は基本的に，#FOLDER，#CONTACT，#SEPERATOR，それと-の4つの要素の繰り返しによって構成される．

#FOLDERは，そこから-が現れるまでの区間をひとつのフォルダとして扱うことを示し，#CONTACTは，次の#CONTACTか-が現れるまでの区間をひとつの widget として扱うことを示す．

#SEPERATOR は区切り線を表し，任意の位置に出現する．

#FOLDER，#CONTACT，#SEPERATOR，-の4つは行の先頭にあり，それ以外の属性は，タブ(U+09)，名，"="(U+3D)，値という構造をしている．

`#FOLDER`

Contacts Panel でフォルダとして表示される．

`#FOLDER` の属性一覧
属性名	とり得る値	属性の種類	備考
ID	整数値	必須	すべての`#FOLDER`，`#CONTACT`，`#SEPARATOR`に共通して付けられる．一意の非負整数値．値は各種 *.adr 全てに亘って一意の値．
NAME	文字列	任意	識別のための名前．何でもいい．
CREATED	UnixTime	任意	作られた時刻のUnixTime(00:00:00 UTC， January 1， 1970からの経過秒を表す)値
ACTIVE	YES	任意	選択されているかどうかを示す．
EXPANDED	YES (NO)	任意	開かれている状態かどうかを示す．
TRASH FOLDER	YES	任意	ゴミ箱(相当)のフォルダにのみ付く．

`#CONTACT`

個々の連絡先を表す．

`#CONTACT` の属性一覧
属性名	とり得る値	属性の種類	備考
ID	整数値	強制	すべての`#FOLDER`，`#CONTACT`，`#SEPARATOR`に共通して付けられる．一意の非負整数値．仔細は #FOLDER の ID属性を参照．
NAME	文字列	任意	識別のための名前．
URL	URL	任意	Homepage として登録した URL．
DESCRIPTION	文字列	任意	Notes のタブのdescriptionの文字列．改行は，U+02 U+02 に変換されて保存される．
SHORT NAME	文字列	任意	Chat のタブの nickname に対応する文字列．
MAIL	メールアドレス	任意	連絡先のメールアドレス． Notes のタブで Additional E-mail address で追加のアドレスを登録すると，`first@example.com U+02 U+02 second@example.com` となる．
PHONE	文字列	任意	電話番号のようだが，入力文字の種別に特に制限は無い．
FAX	文字列	任意	FAX番号のようだが，入力文字の種別に特に制限は無い．
POSTALADDRESS	文字列	任意	住所のようだが，入力文字の種別に特に制限は無い．
PICTUREURL	URL	任意	General のタブで表示される画像の URL, ローカルのファイルも file: schema で登録できる．
ICON	URLかContactX	強制	Contacts Panelなどで表示されるアイコンのURL もしくは組み込みのアイコン名 (ContactX; X は 0から 37?までの数)
CREATED	UnixTime	強制	アイテムが作られた時刻のunixtime(00:00:00 UTC， January 1， 1970からの経過秒を表す)値
ACTIVE	YES	任意	Operaの終了時にアクティブだった場合につく．

`#SEPARATOR`

区切り線を表す．

`#SEPARATOR` の属性一覧
属性名	とり得る値	属性の種類	備考
ID	整数値	強制	省略．仔細は #FOLDER の ID属性を参照．

構成

フォルダの階層構造についてはOpera6.adr の構成と同様なので省略．

カスタマイズ

変換用のツール

参考文献

更新履歴

2007/07/15 : 初版

cookies4.dat

Mon, 01 Sep 2008 08:10:00 +0900

cookies4.dat

meta-creation_date: 2007-06-18T17:55:15+09:00

Opera の cookie を管理するファイル cookies4.dat についての解析．

注意

この文書は，WindowsXPにWindows版の Opera9をインストールしたときの情報に基づいて作成してます．別のOS，別のバージョンの解析状況は追々．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

このページでは，OperaのCookie管理ファイル( cookies4.dat )について解説しています．

「ユーザごとの設定を使う」でインストールすると，通常，%APPDATA%\Opera\Opera\profile\以下に作られます． (%APPDATA%は，通常Documents and Settings\user_name\Application Data．エクスプローラの「ツール→フォルダオプション→表示→全てのファイルとフォルダを表示する」が設定されていないと見ることは出来ないです)．正確な場所は opera:config#UserPrefs|CacheDirectory4の値を参照のこと．

ここにまとめた情報は主に，Opera File Formatsの公式の解説を基に作られています．ほかの資料は参考文献を参照してください．

構造

データ構造(レコード)についての概要は，binary filesを参照のこと．

cookies4.dat ファイルはヘッダと訪問済みリンク情報のデータレコードからなる．

ヘッダ

ヘッダは，4つの値からなり， cookies4.dat のヘッダの4つの値はそれぞれ次のようになっている．

file version number: 0x0000 1000
app. version number: 0x0002 0000
idtag_length: 0x0001
length_length: 0x0002

なので，まとめるとファイルの先頭は以下のようになる．

     0        8        16       24
    +--------+--------+--------+--------+
    |  0x00  |  0x00  |  0x10  |  0x00  |
    +--------+--------+--------+--------+
    |  0x00  |  0x02  |  0x00  |  0x00  |
    +--------+--------+--------+--------+
    |  0x00  |  0x01  |  0x00  |  0x02  |
    +--------+--------+--------+--------+

本体

cookies4.dat ファイルの本体はドメイン，パス，クッキー本体の3種類のレコードと，ドメインの終了フラグ，パスの終了フラグのみの2種類のレコードの計5種類のレコードからなる．

これらの5種類のレコードは，Opera File Formats 似よれば以下のような構造を構成する．

["com" record]
 ["opera" record]
  ["www" record]
   [cookies]
   [Path components]
   [Path component terminator]
   [other domains]
   [end of domain flag ("www")]
  [end of domain flag ("opera")]
 [end of domain flag ("com")]

まず，TLDのレコードがあり，ドメインのレコード，必要ならばさらに細かいサブドメインのレコードが続く．パスのレコードがない場合でも，パスの終了フラグのレコードはある．

cookies4.dat ファイルで使われるレコードのタグIDとペイロードは以下の通り．vlink4.dat等と共通の要素と，いくつかの専用の要素からなる．

cookies4.dat のトップレベルのレコードの構成
タグID	ペイロードの型	説明
`0x01`	レコード	ドメインのレコード．
`(0x04 \| MSB_VALUE)`	flag	ドメインの終了フラグ
`0x02`	レコード	パスのレコード．
`(0x05 \| MSB_VALUE)`	flag	パスの終了フラグ
`0x0003`	レコード	クッキーのレコード．

ドメインのレコード
タグの値	内容の型	説明
0x001E	string	ドメインの部分の名前
0x001F	int8	このドメインに対するクッキーをどうフィルタリングするかをあらわす．このレコードがない場合，上位ドメインの設定が使われる．このドメインからの全クッキーを受け入れる．このドメインからの全クッキーを拒否する．このサーバからの全クッキーを受け入れる．上位ドメインでの設定より優先される．このサーバからの全クッキーを拒否する．上位ドメインでの設定より優先される. ドメインに対する設定は，サブドメインに対する設定で上書きしない限り全サブドメインに対して適用される．
0x0021	int8	URLとは一致しないpath情報を含んだクッキーの取り扱う方法を定める．プライバシーの設定で受け入れる設定にしているとユーザに警告するようになるが，「警告する」が有効になっているときドメインによってフィルタリングされる．拒否するときは 1, 受け入れるときは 2. (Handling of cookies that have explicit paths which do not match the URL setting the cookies. If enabled in the privacy preferences the default is to warn the user, but when warning is enabled such cookies can be filtered by their domains: Value 1 indicates reject, and 2 is accept automatically.)
0x0025	int32	"Warn about third party cookies" モードになっているとき，このフィールドはその種のクッキーのフィルタリングに使われる. すべてのサードパーティーのクッキーを受け入れる．すべてのサードパーティーのクッキーを拒否する．このサーバからのすべてのサードパーティーのクッキーを受け入れる．上位ドメインでの設定より優先される．このサーバからのすべてのサードパーティーのクッキーを拒否する．上位ドメインでの設定より優先される．ドメインに対する設定は，サブドメインに対する設定で上書きしない限り全サブドメインに対して適用される．
0x0026	int32	不詳

パスのレコード
タグの値	内容の型	説明
0x001D	string	pathパートの名前

クッキーのレコード
タグの値	内容の型	説明
0x0010	string	クッキーの名前
0x0011	string	クッキーの値
0x0012	time_t	有効期限 (Expiry date)
0x0013	time_t	最後に使われた日時 (Last used)
0x0014	string	RFC 2965 で使われる Comment/Description
0x0015	string	RFC 2965 における Comment/Description に対する URL
0x0016	string	version=1 のクッキー(cf. RFC 2965)を受け取ったドメイン．
0x0017	string	version=1 のクッキー(cf. RFC 2965)を受け取ったpath．
0x0018	string	version=1 のクッキー(cf. RFC 2965)を受け取った port limitations
(0x0019 \| MSB_VALUE)	flag	HTTPSのサーバにのみ送信する．
0x001A	int8+	クッキーのバージョン(RFC 2965)
(0x001B \| MSB_VALUE)	flag	送信元のサーバにのみクッキーを送信する．
(0x001C \| MSB_VALUE)	flag	予約(削除保護の機能に)
(0x0020 \| MSB_VALUE)	flag	path が URL のprefix だったとき送信しない．たとえば path が /foo のとき /foo/bには送信しますが /foobar には送信しない.
(0x0022 \| MSB_VALUE)	flag	パスワードのログインフォームの結果のクッキー．もしくはそのクッキーにさかのぼれるURLからのクッキー．
(0x0023 \| MSB_VALUE)	flag	HTTP 認証による結果のクッキー．もしくはそのクッキーにさかのぼれるURLからのクッキー．
(0x0024 \| MSB_VALUE)	flag	"Display Third party cookies" モードのとき，サードパーティーのサーバからのクッキーに対してこのフラグがセットされる．また，このフラグの付いたクッキーは取得するURLがそのサードパーティーのものだった場合にのみ，送信される．サーバからあるリソースの読み込み中に受け取った cookie はサードパーティーのURLには送信されない．The reverse is NOT true. NOTE: サードパーティーのサーバからもともとのサーバにリダイレクトするとき，リダイレクト先のURLはサードパーティサーバとみなされる．

構成

YAML(google://YAML)っぽい書式を使ってまとめるとファイルの構成は次のようになる．()

      header :
        file version number : 0x0000 1000 
        app version number  : 0x0002 0000 
        tag_id length       : 0x0001      
        length length       : 0x0002      
      body :
        - domain record :
            tag     : 0x01
            length  : 0xLLLL
            payload :
              domain_part_name :
                tag     : 0x001E
                length  : 0xLLLL
                payload : domain # 文字列(長さ domain_part_name record length)
              filtering_rule : 
                tag     : 0x001F
                length  : 0x0004
                payload : 0x0000 00RR # 
              explicit paths cookie handling rule : 
                tag     : 0x0021
                length  : 0x0004
                payload : 0x0000 00RR # 
              third party cookie filtering rule :
                tag     : 0x0025
                length  : 0x0004
                payload : 0x0000 00RR
        - path record :
            tag     : 0x02
            length  : 0xLLLL
            payload : 
              path_part_name : 
                tag     : 0x001D
                length  : 0xLLLL
                payload : path # 文字列
        - cookie record :
            tag     : 0x03
            length  : 0xLLLL
            payload : 
              cookie_name : 
                tag     : 0x0010
                length  : 0xLLLL
                payload : name # 文字列
              cookie_value : 
                tag     : 0x0011
                length  : 0xLLLL
                payload : value # 文字列
              expiry_date : 
                tag     : 0x0012
                length  : 0x0004
                payload : 0xTTTT TTTT # time_t 
              last_used :
                tag     : 0x0013
                length  : 0x0004
                payload : 0xTTTT TTTT # time_t
              rfc_2965_comment :
                tag     : 0x0014
                length  : 0xLLLL
                payload : value # 文字列
              rfc_2965_comment_url :
                tag     : 0x0015
                length  : 0xLLLL
                payload : value # 文字列
              v1_cookie_domain :
                tag     : 0x0016
                length  : 0xLLLL
                payload : value # 文字列
              v1_cookie_path :
                tag     : 0x0017
                length  : 0xLLLL
                payload : value # 文字列
              v1_cookie_port :
                tag     : 0x0018
                length  : 0xLLLL
                payload : value # 文字列
              https_flag :
                tag     : 0x0019
              cookie_version :
                tag     : 0x001a
                length  : 0x0004
                payload : 0xVVVV VVVV 
              only_sender_flag :
                tag     : 0x001b
              reserved_flag :
                tag     : 0x001c
              prefix_non_send_flag :
                tag     : 0x0020
              login_result_cookie_flag :
                tag     : 0x0022
              http_auth_cookie_flag :
                tag     : 0x0023
              third_party_send_flag :
                tag     : 0x0024
        - path_end_flag :
            tag     : 0x05
        - cookie_end_flag :
            tag     : 0x04

参考文献

Off: Opera File Formats, http://www.opera.com/docs/fileformats/ , opera.com
Off_jp: Opera のファイル形式, http://jp.opera.com/docs/fileformats/ , jp.opera.com
unofficial: Opera File Formats(私家訳), http://ashula.info/neta/opera/inis/OperaFileFormats-jp.html , t.ashula
O4FE: Opera4 File Explorer, http://users.westelcom.com/jsegur/O4FE.HTM , Josef W. Segur

更新履歴

2007/06/11 : 初版

dcache4.url

Mon, 01 Sep 2008 08:10:01 +0900

dcache4.url

meta-author: t.ashula meta-creation_date: 2007-06-11-T23:34:32+09:00

Opera のcache を管理するファイル dcache4.url についての解析．

注意

この文書は，WindowsXPにWindows版の Opera9をインストールしたときの情報に基づいて作成してます．別のOS，別のバージョンの解析状況は追々．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

このページでは，Operaのディスクキャッシュファイル( dcache4.url )について解説しています．

「ユーザごとの設定を使う」でインストールすると，通常，%APPDATA%\Opera\Opera\profile\cache4以下に作られます． (%APPDATA%は，通常Documents and Settings\user_name\Application Data．エクスプローラの「ツール→フォルダオプション→表示→全てのファイルとフォルダを表示する」が設定されていないと見ることは出来ないです)．正確な場所は opera:config#UserPrefs|CacheDirectory4の値を参照のこと．

Opera 9.5 for Windows では，移動プロファイルへの対応がなされており，キャッシュフォルダがC:\Document and Settings\user_name\Local Settings\Application Data\Opera\Opera\profile\cache4\に変更されています．

C:\Documents and Settings\yokozawa

ここにまとめた情報は主に，Opera File Formatsの公式の解説を基に作られています．ほかの資料は参考文献を参照してください．

構造

データ構造(レコード)についての概要は，binary filesを参照のこと．

dcache4.url ファイルはヘッダと訪問済みリンク情報のデータレコードからなる．

ヘッダ

ヘッダは，4つの値からなり， dcache4.url のヘッダの4つの値はそれぞれ次のようになっている．

file version number: 0x0000 1000
app. version number: 0x0002 0000
idtag_length: 0x0001
length_length: 0x0002

なので，まとめるとファイルの先頭は以下のようになる．

     0        8        16       24       32
    +--------+--------+--------+--------+
    |  0x00  |  0x00  |  0x10  |  0x00  |
    +--------+--------+--------+--------+
    |  0x00  |  0x02  |  0x00  |  0x00  |
    +--------+--------+--------+--------+
    |  0x00  |  0x01  |  0x00  |  0x02  |
    +--------+--------+--------+--------+

本体

dcache4.url ファイルの本体はディスクキャッシュに関する情報のレコードの集合からなる．

dcache4.url ファイルで使われるレコードのタグIDとペイロードは以下の通り．vlink4.dat等と共通の要素と，いくつかの専用の要素からなる．

dcache4.url のトップレベルのレコードの構成
タグID	ペイロードの型	説明
`0x01`	レコード	個々のキャッシュファイルに関するレコード．
`0x40`	string	次に使えるキャッシュファイルの5文字( oprXXXXX の XXXXX 部分 )．

個々のキャッシュに関するレコードの構成

タグID

ペイロードの型

説明

0x03

string

完全なURLの名前(The name of the URL, fully qualified)

0x04

time_t

最終訪問日時

(0x0b | MSB_VALUE)

flag

そのURLがフォームの問い合わせ結果であるときにのみ存在

0x22

レコード

その文書に存在する相対リンクのレコード

0x05

time_t

ローカルの時間帯でのファイルの最終取得日時．

0x07

uint8

ファイル取得の状態
値	意味
2	取得済み
4	取得中断
5	取得失敗

0x08

uint32

キャッシュしたファイルのサイズ

0x09

string

キャッシュしたファイルの MIME type

0x0a

string

キャッシュしたファイルの文字集合 (Character set of content)

(0x0c | MSB_VALUE)

flag

キャッシュフォルダ以外の場所にダウンロードされたかどうか

0x0d

string

ファイル名 (cache files: キャッシュディレクトリに相対)

(0x0f | MSB_VALUE)

flag

ファイルが更新されたかどうか．更新されてたら存在．

0x10

レコード

HTTP での通信に関する情報のレコード

相対リンクのレコードの構成
タグID	ペイロードの型	説明
0x23	string	相対リンクのURL
0x24	time_t	最終訪問日時

HTTP での通信に関する情報のレコードの構成
タグID	ペイロードの型	説明
0x15	string	HTTP date header
0x16	time_t	Expiry date
0x17	string	Last modified date
0x18	string	MIME type of document
0x19	string	Entity tag
0x1A	string	Moved to URL (Location header)
0x1B	string	Response line text
0x1C	uint32	Response code
0x1D	string	Refresh URL
0x1E	uint32	Refresh delta time
0x1F	string	Suggested file name
0x20	string	Content Encodings
0x21	string	Content Location
0x25	uint32(string)	タグ `0x26`と一緒に使い，最後にリソースを取得したときに使った User Agent の文字列をあらわす．
0x26	uint32(string)	タグ `0x25`と一緒に使い，最後にリソースを取得したときに使った User Agent の sub version をあらわす．
(0x30 \| MSB_VALUE)	flag	(予約領域)
(0x31 \| MSB_VALUE)	flag	(予約領域)
0x3a	uint32	(不詳)

各レコードの名称と意味の詳細はHypertext Transfer Protocol -- HTTP/1.1を参照

構成

YAML(google://YAML)っぽい書式を使ってまとめるとファイルの構成は次のようになる．()

Opera 9.5 では，64bit への対応がされているため，time_t が 8byte(64bit)の値になってます．

      header :
        file version number : 0x0000 1000 
        app version number  : 0x0002 0000 
        tag_id length       : 0x0001      
        length length       : 0x0002      
      body :
        - download file record :
            tag     : 0x41
            length  : 0xLLLL
            payload :
              url_name :
                tag     : 0x03
                length  : 0xLLLL
                payload : url # 文字列(長さ url_name record length)
              last_visit : 
                tag     : 0x04
                length  : 0x0004 
                  ( 9.5 : 0x0008 )
                payload : 0xTTTT TTTT # time_t 型
                  ( 9.5 : 0xTTTT TTTT TTTT TTTT ) # time_t 型
              rel_url_info :
                tag     : 0x22
                length  : 0xLLLL
                payload : 
                  rel_url_name :
                    tag     : 0x23
                    length  : 0xLLLL
                    payload : url # 文字列(長さ rel_url_name record length)
                  rel_url_last  :
                    tag     : 0x24
                    length  : 0x0004
                      ( 9.5 : 0x0008 )
                    payload : 0xTTTT TTTT # time_t 型
                      ( 9.5 : 0xTTTT TTTT TTTT TTTT ) # time_t 型
              local_download_time :
                tag     : 0x05
                length  : 0x0004
                  ( 9.5 : 0x0008 )
                payload : 0xTTTT TTTT # time_t 型
                  ( 9.5 : 0xTTTT TTTT TTTT TTTT ) # time_t 型
              download_state :
                tag     : 0x07
                length  : 0x0001
                payload : ( 0x02 | 0x04 | 0x05 ) # 2,4,5 のどれか
              download_file_size :
                tag     : 0x08
                length  : 0x0004
                payload : 0xLLLL LLLL 
              mime_type :
                tag     : 0x09
                langth  : 0xLLLL
                payload : MIME-type
              char_set  :
                tag     : 0x0a
                length  : 0xLLLL
                payload : char-set # 文字集合
              file_name :
                tag     : 0x0d
                length  : 0xLLLL
                payload : file name # ローカルでのファイル名
              is_in_cache_folder :
                tag     : 0x8c #  0x0c flag
              is_file_edited :
                tag     : 0x8d #  0x0d flag
              http_com_result :
                tag     : 0x10 
                length  : 0xLLLL
                payload : 
                  http_date_header : 
                    tag     : 0x15
                    length  : 0xLLLL
                    payload : HTTP date header
                  http_expiry_date :
                    tag     : 0x16 
                    length  : 0x0004
                      ( 9.5 : 0x0008 )
                    payload : 0xTTTT TTTT # time_t 型
                      ( 9.5 : 0xTTTT TTTT TTTT TTTT ) # time_t 型
                  http_last_mod_date :
                    tag     : 0x17
                    length  : 0xLLLL 
                    payload : last modified date # http date format ?
                  http_mime_type :
                    tag     : 0x18
                    length  : 0xLLLL
                    payload : mime-type
                  http_entity_tag :
                    tag     : 0x19
                    length  : 0xLLLL
                    payload : ETag
                  http_location_header :
                    tag     : 0x1a
                    length  : 0xLLLL
                    payload : MovedToURL
                  http_response_line :
                    tag     : 0x1b
                    length  : 0xLLLL
                    payload : response-line-text
                  http_response_code :
                    tag     : 0x1c
                    length  : 0x0004
                    payload : 0xVVVV VVVV
                  http_refresh_url :
                    tag     : 0x1d
                    length  : 0xLLLL
                    payload : refresh-url
                  http_refresh_delta_time :
                    tag     : 0x1e
                    length  : 0x0004
                    payload : 0xVVVV VVVV
                  http_suggested_file_name :
                    tag     : 0x1f
                    length  : 0xLLLL
                    payload : suggested-file-name
                  http_content_encoding :
                    tag     : 0x20
                    length  : 0xLLLL
                    payload : encoding 
                  http_content_location :
                    tag     : 0x21
                    lenght  : 0xLLLL
                    payload : location
                  http_user_agent :
                    tag     : 0x25
                    length  : 0xLLLL
                    payload : user-agent-string
                  http_user_agent_subversion :
                    tag     : 0x26
                    length  : 0xLLLL
                    payload : user-agent-subversion-string
                  unknown_http_com_record : # 0x3a 不詳なレコード 
                    tag     : 0x3a    
                    length  : 0x0004
                    payload : OxVVVV VVVV 
                  reserved_flag_1 :
                    tag     : 0xC0    # 0x30 予約領域
                  reserved_flag_2 :
                    tag     : 0xC1    # 0x31 予約領域

参考文献

Off: Opera File Formats, http://www.opera.com/docs/fileformats/ , opera.com
Off_jp: Opera のファイル形式, http://jp.opera.com/docs/fileformats/ , jp.opera.com
unofficial: Opera File Formats(私家訳), http://ashula.info/neta/opera/inis/OperaFileFormats-jp.html , t.ashula
O4FE: Opera4 File Explorer, http://users.westelcom.com/jsegur/O4FE.HTM , Josef W. Segur

更新履歴

2008/01/28 : 2nd : Opera 9.5 にあわせた記述に改訂
2007/06/11 : 初版

Download.dat

Mon, 12 May 2008 16:33:50 +0900

Download.dat

meta-creation_date: 2006-11-04T23:34:32+09:00

Opera のTransfer を管理するファイル download.dat についての解析．

注意

この文書は，WindowsXPにWindows版の Opera9をインストールしたときの情報に基づいて作成してます．別のOS，別のバージョンの解析状況は追々．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

このページでは，Operaのダウンロードレスキューファイル( download.dat )について解説しています．

「ユーザごとの設定を使う」でインストールすると，通常，%APPDATA%\Opera\Opera\profile以下に作られます． (%APPDATA%は，通常Documents and Settings\user_name\Application Data．エクスプローラの「ツール→フォルダオプション→表示→全てのファイルとフォルダを表示する」が設定されていないと見ることは出来ないです)．正確な場所は opera:config#UserPrefs|OperaDirectoryの値を参照のこと．

ここにまとめた情報は主に，Opera File Formatsの公式の解説を基に作られています．ほかの資料は参考文献を参照してください．

構造

データ構造(レコード)についての概要は，binary filesを参照のこと．

download.dat ファイルはヘッダと訪問済みリンク情報のデータレコードからなる．

ヘッダ

ヘッダは，4つの値からなり， download.dat のヘッダの4つの値はそれぞれ次のようになっている．

file version number: 0x0000 1000
app. version number: 0x0002 0000
idtag_length: 0x0001
length_length: 0x0002

なので，まとめるとファイルの先頭は以下のようになる．

     0        8        16       24
    +--------+--------+--------+--------+
    |  0x00  |  0x00  |  0x10  |  0x00  |
    +--------+--------+--------+--------+
    |  0x00  |  0x02  |  0x00  |  0x00  |
    +--------+--------+--------+--------+
    |  0x00  |  0x01  |  0x00  |  0x02  |
    +--------+--------+--------+--------+

本体

download.dat ファイルの本体はダウンロードファイルに関する情報のレコードの集合からなる．

download.dat ファイルで使われるレコードのタグIDとペイロードは以下の通り．vlink4.dat等と共通の要素と，いくつかの専用の要素からなる．

download.dat のトップレベルのレコードの構成
タグID	ペイロードの型	説明
`0x41`	レコード	個々のダウンロードファイルに関するレコード．

個々のダウンロードファイルに関するレコードの構成

タグID

ペイロードの型

説明

0x03

string

完全なURLの名前(The name of the URL, fully qualified)

0x04

time_t

最終訪問日時

(0x0b | MSB_VALUE)

flag

そのURLがフォームの問い合わせ結果であるときにのみ存在

0x22

レコード

その文書に存在する相対リンクのレコード

0x05

time_t

ローカルの時間帯でのファイルの最終取得日時．

0x07

uint8

ファイル取得の状態
値	意味
2	取得済み
4	取得中断
5	取得失敗

0x08

uint32

ダウンロードファイルのサイズ

0x09

string

ダウンロードファイルの MIME type

0x0a

string

ダウンロードファイルの文字集合 (Character set of content)

(0x0c | MSB_VALUE)

flag

キャッシュフォルダ以外の場所にダウンロードされたかどうか

0x0d

string

ファイル名 (cache files: キャッシュディレクトリに相対)

(0x0f | MSB_VALUE)

flag

ファイルが更新されたかどうか．更新されてたら存在．

0x10

レコード

HTTP での通信に関する情報のレコード

0x28

time_t

ダウンロードファイルの前回の取得開始時刻．

0x29

time_t

ダウンロードファイルの前回の取得中止時刻．

0x2A

uint32

ファイルの前回のダウンロードで取得したバイト数．ファイルの取得終了時刻が不明のとき，この値は 0 とみなされ，ダウンロード速度も0(不明値)にセットされる．

相対リンクのレコードの構成
タグID	ペイロードの型	説明
0x23	string	相対リンクのURL
0x24	time_t	最終訪問日時

HTTP での通信に関する情報のレコードの構成
タグID	ペイロードの型	説明
0x15	string	HTTP date header
0x16	time_t	Expiry date
0x17	string	Last modified date
0x18	string	MIME type of document
0x19	string	Entity tag
0x1A	string	Moved to URL (Location header)
0x1B	string	Response line text
0x1C	uint32	Response code
0x1D	string	Refresh URL
0x1E	uint32	Refresh delta time
0x1F	string	Suggested file name
0x20	string	Content Encodings
0x21	string	Content Location
0x25	uint32(string)	タグ `0x26`と一緒に使い，最後にリソースを取得したときに使った User Agent の文字列をあらわす．
0x26	uint32(string)	タグ `0x25`と一緒に使い，最後にリソースを取得したときに使った User Agent の sub version をあらわす．
(0x30 \| MSB_VALUE)	flag	(予約領域)
(0x31 \| MSB_VALUE)	flag	(予約領域)

各レコードの名称と意味の詳細はHypertext Transfer Protocol -- HTTP/1.1を参照

構成

YAML(google://YAML)っぽい書式を使ってまとめるとファイルの構成は次のようになる．()

      header :
        file version number : 0x0000 1000 
        app version number  : 0x0002 0000 
        tag_id length       : 0x0001      
        length length       : 0x0002      
      body :
        - download file record :
            tag     : 0x41
            length  : 0xLLLL
            payload :
              url_name :
                tag     : 0x03
                length  : 0xLLLL
                payload : url # 文字列(長さ url_name record length)
              last_visit : 
                tag     : 0x04
                length  : 0x0004
                payload : 0xTTTT TTTT # time_t 型
              rel_url_info :
                tag     : 0x22
                length  : 0xLLLL
                payload : 
                  rel_url_name :
                    tag     : 0x23
                    length  : 0xLLLL
                    payload : url # 文字列(長さ rel_url_name record length)
                  rel_url_last  :
                    tag     : 0x24
                    length  : 0x0004
                    payload : 0xTTTT TTTT # time_t 型 
              local_download_time :
                tag     : 0x05
                length  : 0x0004
                payload : 0xTTTT TTTT # time_t 型
              download_state :
                tag     : 0x07
                length  : 0x0001
                payload : ( 0x02 | 0x04 | 0x05 ) # 2,4,5 のどれか
              download_file_size :
                tag     : 0x08
                length  : 0x0004
                payload : 0xLLLL LLLL 
              mime_type :
                tag     : 0x09
                langth  : 0xLLLL
                payload : MIME-type
              char_set  :
                tag     : 0x0a
                length  : 0xLLLL
                payload : char-set # 文字集合
              file_name :
                tag     : 0x0d
                length  : 0xLLLL
                payload : file name # ローカルでのファイル名
              last_download_start_time :
                tag     : 0x28
                length  : 0x0004
                payload : 0xTTTT TTTT #
              last_download_stop_time :
                tag     : 0x29
                length  : 0x0004
                payload : 0xTTTT TTTT
              last_download_length :
                tag     : 0x2a
                length  : 0x0004
                payload : 0xLLLL # ファイルの取得終了時刻が有効のときのみ有効
              is_in_cache_folder :
                tag     : 0x8c #  0x0c flag
              is_file_edited :
                tag     : 0x8d #  0x0d flag
              http_com_result :
                tag     : 0x10 
                length  : 0xLLLL
                payload : 
                  http_date_header : 
                    tag     : 0x15
                    length  : 0xLLLL
                    payload : HTTP date header
                  http_expiry_date :
                    tag     : 0x16 
                    length  : 0x0004
                    payload : 0xTTTT TTTT  # Expiry date
                  http_last_mod_date :
                    tag     : 0x17
                    length  : 0xLLLL 
                    payload : last modified date # http date format ?
                  http_mime_type :
                    tag     : 0x18
                    length  : 0xLLLL
                    payload : mime-type
                  http_entity_tag :
                    tag     : 0x19
                    length  : 0xLLLL
                    payload : ETag
                  http_location_header :
                    tag     : 0x1a
                    length  : 0xLLLL
                    payload : MovedToURL
                  http_response_line :
                    tag     : 0x1b
                    length  : 0xLLLL
                    payload : response-line-text
                  http_response_code :
                    tag     : 0x1c
                    length  : 0x0004
                    payload : 0xVVVV VVVV
                  http_refresh_url :
                    tag     : 0x1d
                    length  : 0xLLLL
                    payload : refresh-url
                  http_refresh_delta_time :
                    tag     : 0x1e
                    length  : 0x0004
                    payload : 0xVVVV VVVV
                  http_suggested_file_name :
                    tag     : 0x1f
                    length  : 0xLLLL
                    payload : suggested-file-name
                  http_content_encoding :
                    tag     : 0x20
                    length  : 0xLLLL
                    payload : encoding 
                  http_content_location :
                    tag     : 0x21
                    lenght  : 0xLLLL
                    payload : location
                  http_user_agent :
                    tag     : 0x25
                    length  : 0xLLLL
                    payload : user-agent-string
                  http_user_agent_subversion :
                    tag     : 0x26
                    length  : 0xLLLL
                    payload : user-agent-subversion-string
                  reserved_flag_1 :
                    tag     : 0xC0    # 0x30 予約領域
                  reserved_flag_2 :
                    tag     : 0xC1    # 0x31 予約領域

参考文献

Off: Opera File Formats, http://www.opera.com/docs/fileformats/ , opera.com
Off_jp: Opera のファイル形式, http://jp.opera.com/docs/fileformats/ , jp.opera.com
unofficial: Opera File Formats(私家訳), http://ashula.info/neta/opera/inis/OperaFileFormats-jp.html , t.ashula
O4FE: Opera4 File Explorer, http://users.westelcom.com/jsegur/O4FE.HTM , Josef W. Segur

更新履歴

2008/01/04 : titleのtypo修正
2006/11/04 : 初版

FastForward.ini

Fri, 09 Oct 2009 12:25:42 +0900

FastForward.ini

meta-creation_date: 2005-10-01T23:33:19+09:00

FastForward 機能の設定ファイル fastforward.ini についての解説．

注意

この文書は，WindowsXPにWindows版の Opera 9.64 をインストールしたときの情報に基づいて作成してます．別のOS，別のバージョンの解析状況は追々．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

fastforward.iniは，FastForwardに使われるiniファイル．

operaのインストールディレクトリと同じところにある．プロファイルフォルダに入れるとそちらが優先される模様

公式の解説によれば，Defines what activates the Fast Forward button; instructions for customization are included in the file　とあり，Fast Forward ボタンを押したときやマウスジェスチャーとかキーボードショートカットで”次(forward)“に対する操作をしたときに，対応する要素があればそれを下に”次”のページを表示してくれる機能．

When viewing a page with no user forward history, Opera will try to detect a possible “forward” link that you can access with a forward gesture or keyboard shortcut. The “Forward” icon will change into a “FastForward” icon when this is possible. Try it with a search engine to go to the “Next page” link, or when reading a multi-page on-line article. It can detect “link-next” elements, and will perform checks to find one if not.

構造

ヘッダと[Fast Forward]セクションからなる．

ヘッダ

3行ほど冒頭に有るが，実質的に最初の一行のみ．残りの2行はコメント

Opera Preferences version 2.1
; This file is part of the Opera browser.
; This file is UTF-8 encoded.

[Fast Forward] セクション

最初に組み込みの検索対象とその重みを設定．

 ;First some built in types and their scores 
  Link element=400
  Wand login=300
  Show image=50
  Next image=200

それぞれの意味は次の通りと思われる．

Link element: "次"は,(おそらく)HEAD要素内の<link rel="next">を表示．defaultではこれが一番重くなっている．
Wand login: "次"として,Wandによるログイン処理を行う．
Show image: "次"として,ページ内の画像を単体で表示する．
Next image: "次"として,(Show imageで見てるときに)その次の画像を表示する．

その後は，次のリンクを検出する単語(もしくは連語)が言語別に連なっている．

とくに指定されていない単語の重みは100．ファイル内の説明からすると，Operaは100以上の値が設定されている単語が含まれているリンクを”次”の対象とするとなっている．

カスタマイズ

このファイルはiniファイルなのでWindowsにおけるiniファイルの文法に従う．

簡単に言うと， Name=Value が基本， ; で始まる行はコメント行， [ , ] で囲まれるとセクション， ” で囲むとそれらの文字はエスケープされる．という文法である．

前半の組込み系

重みを上下させることは可能．なにか要素を増やせるかどうかは不明．

単語

言語別にまとまってはいるが，セクションを構成しているわけではないので，好きなところに好きな単語(あるいは連語)を文法に従って，追加できる．

~~defaultでは，”次へ”だけしか日本語は登録されていないので”次の”を登録すると，「次のページ」，「次の記事へ」などに対応して楽である．~~

完全一致でのみ反応するようになってしまっているので，それらしい単語をいくつも登録する必要がある．

下記のようにあるので，リンクに使われてる文章が，その言葉で始まってるか終わっているなら反応することになってるようだ．

Then other words and their scores.
If no score is given, it defaults to 100
If score is 100 or more, Opera will allow
the word or words to also only be the start or end
word of the whole link text

意味的に「次の」ページに反応してるのではなくて，単に一致するリンク(anchor)をたどるだけなので，たとえば セキュア（SSL） を登録しておくと，LDRのログイン画面でHTTPSの方を FastForwrad で選べるようになる．ついでにHTTPSの方でWandを登録しておけば，マウスジェスチャのみでHTTPSログインが出来るようになる．

ほかに， SSL(https)はこちら を登録しておくと，mixiでも同じようにマウスジェスチャのみのHTTPSログインが出来るようになる．

notes.adr

Mon, 12 May 2008 20:03:39 +0900

notes.adr

meta-author: t.ashula meta-creation_date: 2007-07-15T16:23:03+09:00

Opera のメモ管理ファイル notes.adr の解析．

注意

この文書は，WindowsXPにWindows版の Opera 9.22の情報に基づいて作成してます．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

notes.adrは，Opera のメモ(Note)を管理するためのファイル．

基本的な構造は，Opera6.adrなどと同様．Itemとして #NOTE が用いられる．

構造

notes.adr ファイルは，ヘッダと，本体からなる．文字コードはデフォルトでutf-8が使われる．

数行のヘッダの後，フォルダと個々のメモを表す構造がメモの量だけ繰り返される．

ヘッダ

先頭は，Hotlist書式のversion情報が入る．

その後，ファイルのエンコード情報と，何かのversionが入る．改変が可能かどうかは不明．

Opera Hotlist version 2.0
Options: encoding = utf8, version=3

本体

本体は基本的に，#FOLDER，#NOTE，#SEPERATOR，それと-の4つの要素の繰り返しによって構成される．

#FOLDERは，そこから-が現れるまでの区間をひとつのフォルダとして扱うことを示し，#NOTEは，次の#NOTEか-が現れるまでの区間をひとつの widget として扱うことを示す．

#SEPERATOR は区切り線を表し，任意の位置に出現する．

#FOLDER，#NOTE，#SEPERATOR，-の4つは行の先頭にあり，それ以外の属性は，タブ(U+09)，名，"="(U+3D)，値という構造をしている．

`#FOLDER`

Notes Panel でフォルダとして表示される．

`#FOLDER` の属性一覧
属性名	とり得る値	属性の種類	備考
ID	整数値	必須	すべての`#FOLDER`，`#NOTE`，`#SEPARATOR`に共通して付けられる．一意の非負整数値．値は各種 *.adr 全てに亘って一意の値．
NAME	文字列	任意	識別のための名前．何でもいい．
CREATED	UnixTime	任意	作られた時刻のUnixTime(00:00:00 UTC， January 1， 1970からの経過秒を表す)値
ACTIVE	YES	任意	選択されているかどうかを示す．
EXPANDED	YES (NO)	任意	開かれている状態かどうかを示す．
TRASH FOLDER	YES	任意	ゴミ箱(相当)のフォルダにのみ付く．

`#NOTE`

個々の Note を表す．

`#NOTE` の属性一覧
属性名	とり得る値	属性の種類	備考
ID	整数値	強制	すべての`#FOLDER`，`#NOTE`，`#SEPARATOR`に共通して付けられる．一意の非負整数値．仔細は #FOLDER の ID属性を参照．
NAME	文字列	任意	メモとして保存した文字列本体．改行は，U+02 U+02 に変換されて保存される．
URL	URL	任意	メモを保存したURL．
CREATED	UnixTime	強制	アイテムが作られた時刻のunixtime(00:00:00 UTC， January 1， 1970からの経過秒を表す)値
ACTIVE	YES	任意	Operaの終了時にアクティブだった場合につく．

`#SEPARATOR`

区切り線を表す．

`#SEPARATOR` の属性一覧
属性名	とり得る値	属性の種類	備考
ID	整数値	強制	省略．仔細は #FOLDER の ID属性を参照．

構成

フォルダの階層構造についてはOpera6.adr の構成と同様なので省略．

カスタマイズ

特にいじれるところは無い．

参考文献

更新履歴

2007/07/15 : 初版

Opera6.adr

Wed, 03 Mar 2010 01:25:26 +0900

Opera6.adr

ブックマークファイル bookmarks.adr / opera6.adr についての解説

Opera 10.50 pre-alpha で bookmarks.ini に変更された後，Post-beta fixes にて再度この形式に

注意

この文書は，Opera 10.00 の情報に基づいて作成してます．別のOS，別のバージョンの解析状況は追々．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，t.ashulaまで

説明

bookmarks.adr ( Opera 9以前では opera6.adr ) は，operaにおけるブックマーク(お気に入り)の情報を記載したファイル．

「ユーザごとの設定を使う」でインストールすると，通常 WindowsXP なら Documents and Settings\user_name\Application Data\Opera\Opera\profile，Windows Vista なら Users\user_name\AppData\Roaming\Opera\Opera\profileに作られる．

同時に，opera6.adr.bakという名前でバックアップが作られることがある．

公式の解説は以下の通り(Markup一部改変)．

Saved user data

Filename Use Format Overwritten on install Tweak info [1]

Opera6.adr Stores bookmarks. text/plain no [2] File can be saved and renamed， and another file can be selected. See the local menu on the Bookmarks tab in the Hotlist window.
Editable， but can be changed more easily in the browser. Several third party bookmark managers provide an export function.

Note [1]

Tweak only while Opera is not running， except when told otherwise. Deleting files will cause data loss! Always make backups before making any changes.

Note [2]

The logic behind the bookmark installation:

Try to read [User Prefs]Hot List File Ver2 from the opera6.ini file

Do not alter the value if any found

Default to opera6.adr if no value was found

Try to install an opera6.adr file， preserve existing if the value from 1 was empty

Opera 5 behaved differently.

Saved user data
Filename	Use	Format	Overwritten on install	Tweak info [1]
Opera6.adr	Stores bookmarks.	text/plain	no [2]	File can be saved and renamed， and another file can be selected. See the local menu on the Bookmarks tab in the Hotlist window. Editable， but can be changed more easily in the browser. Several third party bookmark managers provide an export function.

構造

opera6.adr ファイルは，ヘッダと，本体からなる．文字コードはデフォルトでutf-8が使われる．

数行のヘッダの後，フォルダと個々のブックマークを表す構造がブックマークの量だけ繰り返される．

ヘッダ

先頭は，Hotlist書式のversion情報が入る．

その後，ファイルのエンコード情報と，何かのversionが入る．改変が可能かどうかは不明．

  Opera Hotlist version 2.0
  Options: encoding = utf8， version=3

本体

本体は基本的に，#FOLDER，#URLと #SEPARATOR -の4つの要素の繰り返しによって構成される．

#FOLDERは，そこから対応する-が現れるまでの区間をひとつのフォルダとして扱うことを示し，#URLは，次の#URLか-が現れるまでの区間をひとつのアイテムとして扱うことを示す．

#SEPERATOR は区切り線を表し，任意の位置に出現する．

#FOLDER，#URL，#SEPERATOR，-の4つは行の先頭にあり，それ以外の属性は，タブ(U+09)，名，”=”(U+3D)，値という構造をしている．

#FOLDER

`#FOLDER` の属性一覧
属性名	とり得る値	属性の種類	備考
ID	整数値	必須	すべての`#FOLDER`，`#URL`，`#SEPARATOR`に共通して付けられる．一意の非負整数値．値は各種 *.adr 全てに亘って一意の値で，生成された順につけられる．
NAME	文字列	任意	識別のための名前．何でもいい．
DESCRIPTION	文字列	任意	Operaでフォルダのプロパティを編集したときのdescriptionの文字列．改行は，U+02 U+02 に変換されて保存される．
SHORT NAME	文字列	任意	Operaでフォルダのプロパティを編集したときのnicknameに対応する文字列．
ACTIVE	YES (NO)	任意	詳細不明
CREATED	UnixTime	任意	作られた時刻のUnixTime(00:00:00 UTC， January 1， 1970からの経過秒を表す)値
EXPANDED	YES (NO)	任意	開かれている状態かどうかを示す．
ON PERSONALBAR	YES	任意	パーソナルバーに表示するかどうか指定する．表示するときにのみYESで作られる．
PERSONALBAR_POS	整数値	(任意)	ON PERSONALBARがYESの時に何番目に表示するかを指定する．ON PERSONALBARが無ければ無効．
ORDER	非負整数値	任意	詳細不明
TRASH FOLDER	YES	任意	ゴミ箱(相当)のフォルダにのみ付く．
TARGET	mini	不明	Opera Mini との同期 Opera Link のための情報．
MOVE_IS_COPY	YES	任意	移動ではなく，複製扱いになる.
SUBFOLDER_ALLOWED	NO	任意	サブフォルダを持てるか持てないかを表す．
SEPARATOR_ALLOWED	NO	任意	セパレータを持てるか持てないかを表す．
MAX_ITEMS	非負整数	任意	不明

#URL

`#URL` の属性一覧
属性名	とり得る値	属性の種類	備考
ID	整数値	強制	すべての`#FOLDER`，`#URL`に共通して付けられる．一意の非負整数値．
NAME	文字列	任意	識別のための名前．何でもいい．
URL	URL	任意	ブックマークしたURL．URL以外にも，bookmarkletなどのscript系も可能．必須の項目ではないらしいが，これが無ければoperaは何のアクションも起こさないので事実上必須の項目．
DESCRIPTION	文字列	任意	Operaでアイテムのプロパティを編集したときのdescriptionの文字列．改行は，U+02 U+02 に変換されて保存される．
SHORT NAME	文字列	任意	Operaでブックマークのプロパティを編集したときのnicknameに対応する文字列．
CREATED	UnixTime	強制	アイテムが作られた時刻のUnixTime(00:00:00 UTC， January 1， 1970からの経過秒を表す)値
VISITED	UnixTime	強制	アイテムのURLにアクセスした時刻のUnixTime(00:00:00 UTC， January 1， 1970からの経過秒を表す)値
ICONFILE	アイコンファイル名か，"Bookmark Unvisited"	任意	faviconとして対応するファイル名を示す．
ON PERSONALBAR	YES	任意	パーソナルバーに表示するかどうか指定する．表示するときにのみYESで作られる．
PERSONALBAR_POS	整数値	(任意)	ON PERSONALBARがYESの時に何番目に表示するかを指定する．ON PERSONALBARが無ければ無効．
IN PANEL	YES	任意	パネルに入れるかどうかを指定する．パネルにするときにのみYESになる．
PANEL_POS	整数値	任意	IN PANEL=YESのときにパネル中で何番目に表示するかを指定する．
SMALL SCREEN	YES	任意	パネル内でSmallScreenモードで表示するかどうかを指定する．
ACTIVE	YES	任意	Opera終了時に開かれているとYESになる？
ORDER	非負整数値	任意	詳細不明. 0 - 2147483647 ?

#SEPARATOR

区切り線を表す．

`#SEPARATOR` の属性一覧
属性名	とり得る値	属性の種類	備考
ID	整数値	強制	省略．#FOLDER の ID属性と同様

構成

#FOLDERから-までがひとつのフォルダを構成する．フォルダの階層構造は，

    #FOLDER
        ID=1
        NAME=Parent
    #FOLDER
        ID=2
        NAME=Child
    #URL
        ID=3
        URL=http://example.com/childs_bookmark
        NAME=childs 1
    #SEPARATOR
        ID=7
    #URL
        ID=6
        URL=http://example.com/childs_bookmark2
        NAME=childs 2
    -
    #URL
        ID=4
        URL=http://example.com/Parents_bookmark
        NAME=parents 1
    -
    #URL
        ID=5
        URL=http://example.com/root_bookmark
        NAME=roots 1

というように#FOLDER中に#FOLDERを作成することで表され

    +- Parent
    |  |
    |  +- Child
    |  |  |
    |  |  +- childs 1
    |  |  |
    |  |  +- (separator)
    |  |  |
    |  |  +- childs 2
    |  |
    |  +- parents 1
    |
    +- roots 1

というような構造を構成する．

カスタマイズ

上記の情報で弄れるけども，公式から引用した表にも有るようにこのファイルを弄るよりも，Operaのbookmarkから編集した方が楽である．

また，少ないながらもこの形式に対応したブックマークエディタなどがある．

対応しているもの

オンラインブックマーク
- delicious.com
- SiteBar
ソフトウェア
- BookSync(Windows)
- フローティング・ブックマーク(Windows)

参考文献

offical: Files Used by Opera， http://www.opera.com/docs/operafiles/ ， opera.com

更新履歴

2010/03/02 : Opera 10.50 のベータ版での変更から復帰したので修正．
2008/09/19 : Opera 9.5(OperaLink)に基づいたものに改訂. Vista に関して追加.
2007/10/22 : XML 的にinvalid な記述があったので修正
2007/07/15 : #SEPARTOR の記述を追加，修正．参考文献を追加
2006/09/22 : XML 的にinvalid な記述があったので修正
2006/01/30 : TRASH FOLDER を追加
2005/03/25 : 初版

operaprefs.ini

Thu, 29 Oct 2009 17:13:15 +0900

operaprefs.ini

meta-creation_date: 2009-10-29T17:02:19+09:00

Opera 全体の設定ファイル operaprefs.ini についての解説．

注意

この文書は，WindowsXPに Opera 10 をインストールしたときの情報に基づいて作成してます．別のOS，別のバージョンの解析状況は追々．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，@t_ashula まで

説明

operaprefs.iniは，Opera 10の全般的な設定のための INI ファイル．プロファイルディレクトリにある．

Opera のインストールディレクトリの operaprefs_default.ini の設定に影響される．

構造

ヘッダと以下のセクションからなる．いくつかのセクションは Opera のデフォルトの値を変更すると現れる．

UserPrefs
Extensions
VoiceXML
SecurityPrefs
Install
HotListWindow
State
AutoUpdate
Proxy
Windows
OperaSync
OperaAccount
OperaSyncServer
Performance
Network
Matches
Colors
WebServer
SavedSettings
Fonts
Preferredfonts
Preferredfontsmonospace
Sounds
Multimedia
FileTypesSectionInfo
FileTypes
FileTypesExtension
TrustedProtocols
Mail
Cache
DiskCache
AuthorDisplayMode
UserDisplayMode
Java
CSSGenericFontFamily
Columns

ヘッダ

3行ほど冒頭に有るが，実質的に最初の一行のみ．残りの2行はコメント

Opera Preferences version 2.1
; This file is part of the Opera browser.
; This file is UTF-8 encoded.

ファイルの先頭に BOM(byte order mark)が version 2.1 から追加されている．

UserPrefs

Extensions

VoiceXML

SecurityPrefs

Install

HotListWindow

State

AutoUpdate

Proxy

Windows

OperaSync

OperaAccount

OperaSyncServer

Performance

Network

Matches

Colors

WebServer

SavedSettings

Fonts

Preferredfonts

Preferredfontsmonospace

Sounds

Multimedia

FileTypesSectionInfo

FileTypes

FileTypesExtension

TrustedProtocols

Mail

Cache

DiskCache

AuthorDisplayMode

UserDisplayMode

Java

CSSGenericFontFamily

Columns

override.ini

Tue, 15 Jul 2008 18:23:45 +0900

override.ini

meta-creation_date: 2007-07-15T20:26:28+09:00

SitePreferences 機能の設定ファイル override.ini についての解析．

注意

この文書は，WindowsXPにWindows版の Opera 9.5をインストールしたときの情報に基づいて作成してます．別のOS，別のバージョンの解析状況は追々．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，mailto:office@ashula.infoまで

説明

override.ini は，「サイトごとの設定」で使われるファイル．他に override_downloaded.ini というファイルがサイトごとの設定には使われる．

「ユーザごとの設定を使う」でインストールすると， Opera Direcotry (通常， %APPDATA%\Opera\Opera\profile )以下に作られる．( %APPDATA% は，通常 Documents and Settings\user_name\Application Data )

実際の場所は，opera:config#UserPrefs|OverridesFileの値を参照のこと．

構造

ヘッダと[Overrides]，各ホストに対するセクションの3パートからなる．

ヘッダ

3行ほど冒頭に有るが，実質的に最初の一行のみ．残りの2行はコメント

Opera Preferences version 2.0
; This file is part of the Opera browser.
; This file is UTF-8 encoded.

version 2.1 の場合，BOM がつく．

[Overrides] セクション

設定を上書きするホスト(ドメイン)名が列挙される．ここに挙げられたホスト名でセクションが生成され，設定が保存される．

ホスト名は後方一致になっていて， example.com のセクションがあれば， foo.example.com や bar.example.com にも同様の設定が引き継がれる．ただし， baz.example.com のセクションが有った場合， example.com での設定はさらに上書きされ， baz.example.com のセクションの設定が優先される．

各ホストごとのセクション

KEY=VALUE の形で，各種の設定がかかれる．

KEY はさらに， FOO | BAR という形をしている．KEY (の FOO,BAR) と VALUE は opera:config の項目と一致している．

例えば， User Prefs|User JavaScript=1 は opera:config#UserPrefs|UserJavaScript の設定を上書きする．

ただし，'' opera:config '' にある全てを上書きできるわけではない．基本的には，Site Preferences のダイアログから設定できる項目だけが上書きできる．

カスタマイズ

[Overrides] のセクションに対象のホストを書き，そのホスト名のセクションを追加すれば良い．

前述のように，Site Preferences のダイアログでほとんど全てが設定可能なので，無理にやらないほうが無難．

Search.ini

Fri, 18 Sep 2009 20:04:12 +0900

Search.ini

Operaの検索機能の設定ファイル search.ini について．

注意

この文書は，WindowsXPにWindows版の Opera 9.60 をインストールしたときの情報に基づいて作成してます．別のOS，別のバージョンの解析状況は追々．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

search.iniは，検索の設定に使われるiniファイル．

プロファイルディレクトリ Opera Directoryと，インストールディレクトリに存在する．

公式の解説によれば，基本的にプロファイルディレクトリの設定が優先されるが，プロファイルディレクトリにあるファイルの version がインストールディレクトリにあるものより古い（値が小さい）場合，インストールディレクトリのもので上書きされる．

Settings for the search engines available in Opera, and where they are displayed in the browser.

Only overwritten when the version number in the existing file is lower than that of the search.ini file in the main directory

構造

ヘッダと[Version]，[Search Engine X]セクションからなる．

ヘッダ

3行ほど冒頭に有るが，実質的に最初の一行のみ．残りの2行はコメント

Opera Preferences version 2.1
; This file is part of the Opera browser.
; This file is UTF-8 encoded.

ファイルの先頭に BOM(byte order mark)が version 2.1 から追加されている．

[Version] セクション

ファイルの（書式など）のバージョンを表すセクション．

プロファイルディレクトリのファイルとインストールディレクトリのファイルのうち，この値が新しい（大きい）方が使われる.

サンプル

File Version=19

[Search Engine X] セクション

それぞれの検索エンジンの設定を表すセクション．

最初から登録されている Google 検索などは [Search Engine 1] などと小さい値で，あとから追加したものは100000 以上の値が付けられる．

それぞれの検索エンジンの設定は，以下の要素からなる．

`ID`	数値	各検索エンジンに対して一意の数値．元々用意されてるモノには，1000000未満の値が割り当てられ，あとからユーザが追加したものは1000000以上の数値が割り当てられる．Opera9.6 では UNIQUEID の追加により削除される予定．
`Name`	文字列	アドレスバーからのキーワードでの検索時に，「”何々で”“何々を”検索」の「何々で」に表示される文字列
`Verbtext`	数値	検索フィールドで，「何々”検索”」と表示されるときの「検索」の方の言語ファイルでの番号.0がするとデフォルト．まれに`17063`が指定されていることがあるが，9.5の言語ファイルに該当する項目は無く，`-1988219522=”%s search”`が妥当．
`URL`	文字列(URL)	検索エンジンのURL. Webページに限らず，`javascript:`なども設定可能．URL中の `%s`が検索キーワードで置換される．`%s`などの詳細は後述．
`Query`	文字列	POSTメソッドで検索するときのデータ．ここでも `%s`が検索キーワードで置換される．
`Key`	文字列	アドレスバーなどで検索するときにつかうキー，後述のサンプルでは `gj ほげ` でGoogleで日本語検索になる．
`Is post`	数値(0,1)	POSTメソッドを用いるときに1.
`Has endseparator`	数値(0,1)	検索フィールド内で一覧表示したときや，右クリックのデータベースの検索での表示の際に，この検索エンジンの下に，区切り線を入れるかどうかを指定する．
`Encoding`	特定文字列	`%s`などに渡された文字列を検索エンジンのURLに変換するときのエンコードを指定する．
`Search Type`	数値	以下の検索エンジンの種別の値を指定する．各値の意味は後述．
`Position`	数値	パーソナルバーに表示する際の位置を指定する．パーソナルバーに表示しないときには`-1`にする．
`Nameid`	数値	言語ファイルでのID．値が0以外に設定されると，検索エンジンの説明をOpera本体の言語ファイルから持ってくる．デフォルトのGoogle検索には，`1632215285` が指定されており，言語ファイルの該当IDでは `1632215285=”&Google”`となっている．
`Deleted`	数値(0,1)	削除フラグ．デフォルトで用意されているGoogle検索や eBay検索などは削除できず，このフラグで非表示にするしかできない．あとから追加したものは，フラグではなく本当に消える．
`UNIQUEID`	UUID	128ビットの一意の値．Opera 9.6から検索エンジンも OperaLink の対象になったため追加された．

サンプル

UNIQUEID=7A8CADE6677811DDBA4B5E9D55D89593
ID=1000037
Name=Google ja-JP
Verbtext=0
URL=http://www.google.co.jp/search?hl=en&client=opera&rls=en&as_q=%s&ie=utf-8&lr=lang_ja&safe=off
Query=
Key=gj
Is post=0
Has endseparator=0
Encoding=UTF-8
Search Type=0
Position=-1
Nameid=0
Key=gj
Is post=0
Has endseparator=0
Encoding=UTF-8
Search Type=0
Position=-1
Nameid=0
Deleted=0

検索キーワードの置換

URLとQueryでは，パラメータとして%sと%iとが使える．

%s は検索フィールドの入力文字列や g ほげとしたときの”ほげ”に置換される．スペースなどで区切られた複数の単語は +で連結される．

%i は検索結果の1ページあたりの表示件数を指定する．たとえば Google の検索ではパラメータとして &num=100を追加することで1ページあたり100件の検索結果を表示させることができる．設定はopera:config#UserPrefs|NumberOfHitsから行う．

検索の種類

Search Type に指定する検索の種類とその値は以下の通り．

0 = 普通の検索エンジン
2 = スーパーサーチ
12 = ページ内検索
14 = 履歴検索（History Search）
50 = 辞書検索（Dictionary）
51 = 辞典検索（Encyclopedia）
52 = 通貨変換（Translate currency）
100–117 = 翻訳（Translate）

カスタマイズ

各検索エンジン ([Search Engine X])

Opera の設定ダイアログからは，Name，URL，Query（Is post)，key，Has endseparator，Deleted が設定できる．

Positionはパーソナルバーで追加や削除，移動時に書き換えられる．

日本語環境では重要な Encodingは，Operaから触れないので別の手段で書き換えるほかない．

検索フィールドやコンテキストメニューなどでの表示順は基本的に search.ini に書かれている順番になるため，表示の順番を入れ変えるには，ファイルでの順番を入れ替える必要がある．

外部ツール

Search.ini の管理用のツール．

SeeMe

SeeMe オンラインヘルプ

Microsoft .NET Framework 3.5 が必要．日本語．

Opera のサーチエンジンリスト (Search.ini) を GUI で編集するためのアプリケーションです。

内蔵の編集機能とは違い全体を見ながら追加や編集ができるようにしています。

又 Opera 本体では何故かできないリストの並べ替えや「で検索」の文字を外すとかが可能です。

v3 よりデフォルト検索エンジンの変更や２つインストールした Opera のもう片方の編集も可能になりました

SearchEdit

Search Edit

SearchEdit 日本語チュートリアル

J2SE 6が必要．英語，日本語を含む各言語ファイルあり．

並び替えやキーの設定などの各種編集のほか，重複の検出と削除，OpenSearch 形式への書き出しと結合，別のSearch.iniとの結合などができる．

SearchEdit is a Java-based editor for Opera's search.ini. It allows moving, editing and deleting existing search entries from the search.ini as well as adding/removing separators.

SearchEdit works with search.ini from Opera 9 and higher.

For more information read the tutorial or go to the Forum.

参考資料

SpeedDial.ini

Mon, 14 Jul 2008 14:27:13 +0900

SpeedDial.ini

SpeedDial 機能の設定ファイル speeddial.ini について．

注意

この文書は，WindowsXPにWindows版の Opera 9.51 をインストールしたときの情報に基づいて作成してます．別のOS，別のバージョンの解析状況は追々．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

speeddial.iniは，SpeedDialの設定に使われるiniファイル．

プロファイルディレクトリ Opera Directoryにある． Speed Dial Fileを設定することで，任意のファイルを指定することも可能．

公式の解説には，2008-07-12現在特に記載なし．

構造

ヘッダと[Speed Dial X]セクションからなる．通常 X は 1 から 9 までだが，[Size]セクションを追加することで数を増やしたり減らしたりできる．

ヘッダ

3行ほど冒頭に有るが，実質的に最初の一行のみ．残りの2行はコメント

Opera Preferences version 2.1
; This file is part of the Opera browser.
; This file is UTF-8 encoded.

ファイルの先頭に BOM(byte order mark)が version 2.1 から追加されている．

[Speed Dial X] セクション

それぞれの dial の設定は，以下の 5 つの要素からなる．

Title	文字列	dial のタイトル．SpeedDialの画面で各dialの下に表示される文字列．
Url	文字列(URL)	dial の対象のURL．Webページに限らず，`data:`や `opera:`，`javascript:`など設定可能
Reload Enabled	数値 ( 0 か 1 )	自動更新に関する設定．1にすることで次の Reload Interval と Reload Only If Expired の設定が有効になる
Reload Interval	数値	自動更新の間隔の設定．単位は秒．Reload Enabled=1のときのみ，意味をもつ．Neverにすると2147483647(2の32乗-1)にされる．
Reload Only If Expired	数値 ( 0 か 1 )	ページの期限切れで更新するかどうかの設定．Dialの対象ページが期限 ( Expires )を設定しているときのみ有効．

この各セクションは，OperaLinkでの同期の対象．

サンプル

Google ニュースの日本版を30分で1回更新する場合の設定．

Title=Google ニュース 日本版
Url=http://news.google.com/news?ned=jp
Reload Enabled=1
Reload Interval=1800
Reload Only If Expired=1

[Size] セクション

Dialの縦横の数を設定するセクション．

Opera 側から設定するためのUIはないため，iniファイルを直接書き換えない限り存在しない．

Rows=H で縦（行数）を設定し，Columns=Wで横（列数）を設定する．

最小はどちらも 1 . 最大は画面サイズに依存する．

このセクションは，OperaLinkでの同期の対象ではない．

サンプル

縦に3行，横に4列の場合

[Size]
Rows=3
Columns=4

カスタマイズ

このファイルはiniファイルなのでWindowsにおけるiniファイルの文法に従う．

各 dial ([Speed Dial X])

各 dial の Title 以外はすべてOpera から設定するUIがあるので SpeedDialの画面から設定したほうが楽．

dial 数 ([Size])

Opera 側から設定するためのUIはないため，iniファイルを直接書き換える． Rows, Columns のどちらかだけが指定された場合，指定されてないほうは 3 が指定されているものとされる．

参考資料

Opera Internal/Initialize Files

Wed, 03 Mar 2010 01:14:28 +0900

Opera Internal/Initialize Files

Opera のIniファイルや内部ファイルの構造に関するメモ書き

Adrs

Binaries

Inis
Others
- widgets.dat
- sessionwin

ua.ini

Sun, 22 Jun 2008 22:13:36 +0900

ua.ini

UA値をドメインごとに偽装する設定ファイル ua.ini についての解説．

Opera 9では，overwriteiniに統合されたので削除しました．

vlink4.dat

Mon, 12 May 2008 20:04:20 +0900

vlink4.dat

meta-creation_date: 2006-10-12T23:35:22+09:00

Opera の訪問済みリンクの管理ファイル vlink4.dat についての解析．

注意

この文書は，WindowsXPにWindows版の Opera9をインストールしたときの情報に基づいて作成してます．別のOS，別のバージョンの解析状況は追々．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

このページでは，Operaの訪問済みリンクのファイル( vlink4.dat )について解説しています．

「ユーザごとの設定を使う」でインストールすると，通常，%APPDATA%\Opera\%OperaVersion%\profile以下に作られます． (%APPDATA%は，通常Documents and Settings\user_name\Application Data．エクスプローラの「ツール→フォルダオプション→表示→全てのファイルとフォルダを表示する」が設定されていないと見ることは出来ないです)．正確な場所は opera:config#UserPrefs|OperaDirectoryの値を参照のこと．

ここにまとめた情報は主に，Opera File Formatsの公式の解説を基に作られています．ほかの資料は参考文献を参照してください．

構造

データ構造(レコード)についての概要は，binary filesを参照のこと．

vlink4.dat ファイルはヘッダと訪問済みリンク情報のデータレコードからなる．

ヘッダ

ヘッダは，4つの値からなり， vlink4.dat のヘッダの4つの値はそれぞれ次のようになっている．

file version number: 0x0000 1000
app. version number: 0x0002 0000
idtag_length: 0x0001
length_length: 0x0002

なので，まとめるとファイルの先頭は以下のようになる．

     0        8        16       24
    +--------+--------+--------+--------+
    |  0x00  |  0x00  |  0x10  |  0x00  |
    +--------+--------+--------+--------+
    |  0x00  |  0x02  |  0x00  |  0x00  |
    +--------+--------+--------+--------+
    |  0x00  |  0x01  |  0x00  |  0x02  |
    +--------+--------+--------+--------+

本体

vlink4.dat ファイルの本体は一つ一つの訪問済みURLに関する情報のレコードの集合からなる．

vlink4.dat ファイルで使われるレコードのタグIDとペイロードは以下のとおり

vlink4.dat のトップレベルのレコードの構成
タグID	ペイロードの型	説明
`0x02`	レコード	個々の訪問済みURLに関するレコード．

個々の訪問済みURLに関するレコードの構成
タグID	ペイロードの型	説明
0x03	string	完全なURLの名前(The name of the URL, fully qualified)
0x04	time_t	最終訪問日時
0x8b	flag	そのURLがフォームの問い合わせ結果であるときにのみ存在
0x22	record	その文書に存在する相対リンクの URL と最終訪問日時のレコード

相対リンクのレコードの構成
タグID	ペイロードの型	説明
0x23	string	相対リンクのURL
0x24	time_t	最終訪問日時

構成

YAML(google://YAML)っぽい書式を使ってまとめるとファイルの構成は次のようになる．()

      header :
        file version number : 0x0000 1000 
        app version number  : 0x0002 0000 
        tag_id length       : 0x0001      
        length length       : 0x0002      
      body :
        - visited url record :
            tag     : 0x02
            length  : 0xLLLL
            payload :
              url_name record :
                tag     : 0x03
                length  : 0xLLLL
                payload : url # 文字列(長さ url_name record length)
              last_visit record : 
                tag     : 0x04
                length  : 0x0004
                payload : 0xTTTT TTTT # time_t 型
              rel_url_info record :
                tag     : 0x22
                length  : 0xLLLL
                payload : 
                  rel_url_name record :
                    tag : 0x23
                    length : 0xLLLL
                    payload : url # 文字列(長さ rel_url_name record length)
                  rel_url_last record :
                    tag : 0x24
                    length : 0x0004
                    payload : 0xTTTT TTTT # time_t 型 
        - visited url record :
            tag     : 0x02
            length  : 0xLLLL
            payload :
              url_name record :
                tag     : 0x03
                length  : 0xLLLL
                payload : url # 文字列(長さ url_name record length)
              last_visit record : 
                tag     : 0x04
                length  : 0x0004
                payload : 0xTTTT TTTT # time_t 型
              rel_url_info record :
                tag     : 0x22
                length  : 0xLLLL
                payload : 
                  rel_url_name record :
                    tag : 0x23
                    length : 0xLLLL
                    payload : url # 文字列(長さ rel_url_name record length)
                  rel_url_last record :
                    tag : 0x24
                    length : 0x0004
                    payload : 0xTTTT TTTT # time_t 型

Tools

Opera4 File Explorer, http://users.westelcom.com/jsegur/O4FE.HTM , Josef W. Segur
read opera history file and write into something, http://ashula.info/opera/tips/read_opera_history_file_and_write_into_something.html , t.ashula

参考文献

Off: Opera File Formats, http://www.opera.com/docs/fileformats/ , opera.com
Off_jp: Opera のファイル形式, http://jp.opera.com/docs/fileformats/ , jp.opera.com
unofficial: Opera File Formats(私家訳), http://ashula.info/neta/opera/inis/OperaFileFormats-jp.html , t.ashula
O4FE: Opera4 File Explorer, http://users.westelcom.com/jsegur/O4FE.HTM , Josef W. Segur

更新履歴

2007/07/21 : ツールを追加
2006/10/12 : 初版

Widgets.adr

Thu, 09 Oct 2008 17:29:58 +0900

Widgets.adr

Opera のWidget 管理ファイル widgets.adr の解説．

meta-author: t.ashula
meta-creation_date: 2007-07-15T14:29:36+09:00

注意

この文書は，WindowsXPにWindows版の Opera 9.6 の情報に基づいて作成してます．

この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

widgets.adrは，Opera 9 から追加された widget を管理するためのファイルのひとつ．

widget 本体や設定などは widgets.dat というファイルで管理している．

基本的な構造は，Opera6.adrなどと同様．

#WIDGET が用いられるほか，XPOSITION，YPOSITION などの描画用のパラメータが追加されている．

構造

widgets.adr ファイルは，ヘッダと，本体からなる．文字コードはデフォルトでutf-8が使われる．

数行のヘッダの後，フォルダと個々の widget を表す構造が widgetの量だけ繰り返される．

ヘッダ

先頭は，Hotlist書式のversion情報が入る．

その後，ファイルのエンコード情報と，何かのversionが入る．改変が可能かどうかは不明．

サンプル

Opera Hotlist version 2.0
Options: encoding = utf8, version=3

本体

本体は基本的に，#FOLDER，#WIDGET，#SEPERATOR，それと-の4つの要素の繰り返しによって構成される．

#FOLDERは，そこから-が現れるまでの区間をひとつのフォルダとして扱うことを示し，#WIDGETは，次の#WIDGETか-が現れるまでの区間をひとつの widget として扱うことを示す．

#SEPERATOR は区切り線を表し，任意の位置に出現する．

#FOLDER，#WIDGET，-の3つは行の先頭にあり，それ以外の属性は，タブ(U+09)，名，”=”(U+3D)，値という構造をしている．

#FOLDER

Widgets Panel でフォルダとして表示される．

`#FOLDER` の属性一覧
属性名	とり得る値	属性の種類	備考
ID	整数値	必須	すべての`#FOLDER`，`#WIDGET`，`#SEPARATOR`に共通して付けられる．一意の非負整数値．値は各種 *.adr 全てに亘って一意の値で，生成された順につけられる．
NAME	文字列	任意	識別のための名前．何でもいい．
CREATED	UnixTime	任意	作られた時刻のUnixTime(00:00:00 UTC， January 1， 1970からの経過秒を表す)値
EXPANDED	YES (NO)	任意	開かれている状態かどうかを示す．
TRASH FOLDER	YES	任意	ゴミ箱(相当)のフォルダにのみ付く．

#WIDGET

個々の Widget を表す．

`#WIDGET` の属性一覧
属性名	とり得る値	属性の種類	備考
ID	整数値	強制	すべての`#FOLDER`，`#WIDGET`，`#SEPARATOR`に共通して付けられる．一意の非負整数値．仔細は #FOLDER の ID属性を参照．
NAME	文字列	任意	識別のための名前．何でもいい．通常は widgetの config.xml の `widgetname`要素の値が採用される．
IDENTIFIER	文字列	強制	各 widget に対して何らかの規則で生成され，Widgets.dat でIDとして扱われる文字列． widget フォルダ以下に同名のフォルダが生成され，`cookies4.dat`，`dcache4.url`，`vlink4.dat`が保存される．
XPOSITION	整数値	強制	widget の描画位置のX座標．
YPOSITION	整数値	強制	widget の描画位置のY座標．
CREATED	UnixTime	強制	アイテムが作られた時刻のunixtime(00:00:00 UTC， January 1， 1970からの経過秒を表す)値
SCALE	整数値	強制	widget の表示倍率．通常のページのZoomと同義．
STYLE	0,1,2	強制	widget の表示方法． 0 通常のウィンドウとして表示(Normal) 1 最前面に表示(Always on Top) 2 最背面に表示(Always below)
TYPE	整数値	(任意)	不詳．
CLEAN UNINSTALL	YES	任意	Widgetの追加から入れたかどうか？
CREATED	UnixTime	(強制)	インストール時刻のUnixTime(00:00:00 UTC, January 1, 1970からの経過秒を表す)値
ACTIVE	YES	任意	Operaの終了時にアクティブだった場合につく．

#SEPARATOR

区切り線を表す．

`#SEPARATOR` の属性一覧
属性名	とり得る値	属性の種類	備考
ID	整数値	強制	省略．仔細は #FOLDER の ID属性を参照．

構成

フォルダの階層構造についてはOpera6.adr の構成と同様なので省略．

カスタマイズ

特にいじれるところは無いが，アクティブなはずのウィジェットが画面外で見えないといったときに SCALE=100 STYLE=1 XPOSITION=0 YPOSITION=0 ACTIVE=YESとして再起動して見つけるといったくらいの使い方は出来そう．

参考文献

Widget: Opera Widgets Specification 1.0 - Opera Developer Community, http://dev.opera.com/articles/view/opera-widgets-specification-1-0/ , Opera Software

更新履歴

2007/07/15 : 初版
2008/10/09 : Opera 9.6 に

widgets.dat

Thu, 09 Oct 2008 16:43:38 +0900

widgets.dat

meta-author: t.ashula
meta-creation_date: 2007-07-15T15:34:57+09:00

Opera のWidget 管理ファイル widgets.dat の解説．

注意

この文書は，WindowsXPにWindows版の Opera 9.6の情報に基づいて作成してます．この文書を基にして，Operaにカスタマイズその他の変更を加えて，不具合が発生しても責任は取れません．

突っ込み，感想，その他は，office@ashula.infoまで

説明

widgets.datは，Opera 9 から追加された widget を管理するためのファイルのひとつ．

Widget Panel などで直接ユーザに見える部分は Widgets.adr というファイルで管理している．

「ユーザごとの設定を使う」でインストールすると，Opera Directory(通常，%APPDATA%\Opera\Opera\profile)以下の widgets フォルダに作られる(%APPDATA%は，通常Documents and Settings\user_name\Application Data)．

拡張子こそ dat だが，実際の中身は XML である．

構造

widgets.adr ファイルは，XMLファイルで，ルート要素は preferences

かなりいい加減な DTD で書くと，widgetsdat.dtdのようになるはず．

''preferences''

preferences要素は 1つ以上の section要素を持つ．属性は無し．

''section''

section要素は1つ以上の value要素を持つ．属性として idがある．

id はリテラルの widgetsか 30文字の文字列のどちらか．

リテラルの widgets の設定された section は preferences要素の最初の子要素のみ．それ以外の section要素の idは全て30文字の文字列となっている．この 30文字の文字列は widgets.adrの#WIDGETのIDENTIFIERの値と対応する．

''value''

value要素の内容は #PCDATA で，属性として id がある． id は次の4種類の値をとる．

path to widget data: sectionの最初の子要素にのみ使われる．この要素の内容は widget本体のパスとして扱われる．おそらくは widget の config.xml を含むフォルダで，zipファイルである必要は無い．
number of saved values: section の最後の子要素にのみ使われる．この要素の内容は，後述の key と val の数を表す．key/val が無いときは 0．
key #n: ウィジェットが保存する値の名前(widget.preferenceForKeyの引数)を表す．n には数字が入り，key #0，key #1，key #2と増加する．
val #n: ウィジェットが保存する値(widget.preferenceForKeyの戻り値)を表す．n には数字が入り，val #0，val #1，val #2と増加する．

参考文献

Widget: Opera Widgets Specification 1.0 - Opera Developer Community, http://dev.opera.com/articles/view/opera-widgets-specification-1-0/ , Opera Software

更新履歴

2007/07/15 : 初版
2008/10/10 : Opera 9.60 リリースに合わせて書き直し

Ashula.info opera:inis

Adrs

注意

目次

説明

構造

データ構造

ファイル構造

このフォーマットを採用しているファイル

参考文献

更新履歴

Binaries

注意

目次

説明

構造

データ構造

フラグレコード

ファイル構造

このフォーマットを採用しているファイル

参考文献

更新履歴

bookmarks.ini

﻿contacts.adr

注意

目次

説明

構造

ヘッダ

本体

#FOLDER

#CONTACT

#SEPARATOR

構成

カスタマイズ

参考文献

更新履歴

cookies4.dat

注意

目次

説明

構造

ヘッダ

本体

構成

参考文献

更新履歴

dcache4.url

注意

目次

説明

構造

ヘッダ

本体

構成

参考文献

更新履歴

Download.dat

注意

目次

説明

構造

ヘッダ

本体

構成

参考文献

更新履歴

FastForward.ini

notes.adr

注意

目次

説明

構造

ヘッダ

本体

#FOLDER

#NOTE

#SEPARATOR

構成

カスタマイズ

contacts.adr

`#FOLDER`

`#CONTACT`

`#SEPARATOR`

`#FOLDER`

`#NOTE`

`#SEPARATOR`