Add README and PDB support

README.md

@@ -0,0 +1,35 @@
+# Oracle Clone Script
+
+This script (`oracle_clone.sh`) performs a clone of an Oracle database using the Rubrik CDM API.
+
+## Usage
+
+```bash
+./oracle_clone.sh [options] <srcSID> <tgtHOSTNAME>
+```
+
+- `<srcSID>`: Source Oracle database SID.
+- `<tgtHOSTNAME>`: Target hostname for the clone.
+
+## Options
+
+- `-h <dbhost>`      Source DB hostname
+- `-t <timestamp>`   Recovery point timestamp (`"YYYY-MM-DD HH:MM:SS"`, uses latest if not specified)
+- `-n <newsid>`      New database SID for the clone
+- `-p <pfilepath>`   Custom pfile for the clone
+- `-a <key,value>`   Advanced Cloning Options (can be used multiple times)
+- `-b <pdb1,pdb2>`   Comma-separated list of PDBs to clone (include only these PDBs. `PDB$SEED` is always included)
+- `-d`               Dry run mode - show API payload without executing
+
+## Notes
+
+- The script requires access to the Rubrik API and expects the supporting functions `oracle_funcs.sh` to be present in the same directory.
+- Time is passed to `date` on the local machine and uses the local timezone.
+
+## Example
+
+```bash
+./oracle_clone.sh -h dbhost01 -t "2024-06-01 12:00:00" -n CLONE01 -b PDB1,PDB2 orcl targethost
+```
+
+This will clone the `orcl` database from `dbhost01` to `targethost`, using the specified timestamp, new SID `CLONE01`, and only include `PDB$SEED`, `PDB1`, and `PDB2`.