osList, byte[] vmContent,
int length )
diff --git a/src/main/java/org/openslx/virtualization/configuration/VirtualizationConfigurationQemuUtils.java b/src/main/java/org/openslx/virtualization/configuration/VirtualizationConfigurationQemuUtils.java
index 7ac3632..0288029 100644
--- a/src/main/java/org/openslx/virtualization/configuration/VirtualizationConfigurationQemuUtils.java
+++ b/src/main/java/org/openslx/virtualization/configuration/VirtualizationConfigurationQemuUtils.java
@@ -116,7 +116,7 @@ public class VirtualizationConfigurationQemuUtils
/**
* Converts a Libvirt network device model to a VM metadata ethernet device type.
*
- * @param soundDeviceModel Libvirt network device model.
+ * @param networkDeviceModel Libvirt network device model.
* @return VM metadata ethernet device type.
*/
public static EthernetDevType convertNetworkDeviceModel( Interface.Model networkDeviceModel )
diff --git a/src/main/java/org/openslx/virtualization/configuration/VirtualizationConfigurationVirtualboxFileFormat.java b/src/main/java/org/openslx/virtualization/configuration/VirtualizationConfigurationVirtualboxFileFormat.java
index 6a1f5a5..a0e1a1f 100644
--- a/src/main/java/org/openslx/virtualization/configuration/VirtualizationConfigurationVirtualboxFileFormat.java
+++ b/src/main/java/org/openslx/virtualization/configuration/VirtualizationConfigurationVirtualboxFileFormat.java
@@ -116,7 +116,7 @@ public class VirtualizationConfigurationVirtualboxFileFormat
*
* @param machineDescription content of the XML file saved as a byte array.
* @param length of the machine description byte array.
- * @throws IOException if an
+ * @throws VirtualizationConfigurationException creation of VirtualBox configuration file representation failed.
*/
public VirtualizationConfigurationVirtualboxFileFormat( byte[] machineDescription, int length ) throws VirtualizationConfigurationException
{
@@ -313,7 +313,7 @@ public class VirtualizationConfigurationVirtualboxFileFormat
/**
* Function finds and saves the name of the guest OS
*
- * @throws XPathExpressionException
+ * @throws XPathExpressionException failed to find and retrieve name of the guest OS.
*/
public void setOsType() throws XPathExpressionException
{
@@ -336,7 +336,7 @@ public class VirtualizationConfigurationVirtualboxFileFormat
/**
* Search for attached hard drives and determine their controller and their path.
*
- * @throws XPathExpressionException
+ * @throws XPathExpressionException failed to find attached hard drives and their controllers.
*/
public void setHdds() throws XPathExpressionException
{
@@ -452,6 +452,7 @@ public class VirtualizationConfigurationVirtualboxFileFormat
* @param elementXPath given as an xpath expression
* @param attribute attribute to change
* @param value to set the attribute to
+ * @return state of the change operation whether the attribute was changed successful or not.
*/
public boolean changeAttribute( String elementXPath, String attribute, String value )
{
@@ -491,7 +492,7 @@ public class VirtualizationConfigurationVirtualboxFileFormat
* Adds a new node named nameOfNewNode to the given parent found by parentXPath.
*
* @param parentXPath XPath expression to the parent
- * @param nameOfnewNode name of the node to be added
+ * @param childName name of the node to be added
* @return the newly added Node
*/
public Node addNewNode( String parentXPath, String childName )
diff --git a/src/main/java/org/openslx/virtualization/configuration/data/ConfigurationDataDozModClientToDozModServer.java b/src/main/java/org/openslx/virtualization/configuration/data/ConfigurationDataDozModClientToDozModServer.java
index 0d0c457..8a08d05 100644
--- a/src/main/java/org/openslx/virtualization/configuration/data/ConfigurationDataDozModClientToDozModServer.java
+++ b/src/main/java/org/openslx/virtualization/configuration/data/ConfigurationDataDozModClientToDozModServer.java
@@ -2,7 +2,8 @@ package org.openslx.virtualization.configuration.data;
/**
* Data container to collect and store input arguments for a
- * {@link ConfigurationLogicDozModClientToDozModServer} transformation.
+ * {@link org.openslx.virtualization.configuration.logic.ConfigurationLogicDozModClientToDozModServer}
+ * transformation.
*
* @author Manuel Bentele
* @version 1.0
@@ -11,7 +12,8 @@ public class ConfigurationDataDozModClientToDozModServer
{
/**
* Creates a new data container to collect and store input arguments for a
- * {@link ConfigurationLogicDozModClientToDozModServer} transformation.
+ * {@link org.openslx.virtualization.configuration.logic.ConfigurationLogicDozModClientToDozModServer}
+ * transformation.
*/
public ConfigurationDataDozModClientToDozModServer()
{
diff --git a/src/main/java/org/openslx/virtualization/configuration/data/ConfigurationDataDozModServerToDozModClient.java b/src/main/java/org/openslx/virtualization/configuration/data/ConfigurationDataDozModServerToDozModClient.java
index 7b1c0b4..4e18d48 100644
--- a/src/main/java/org/openslx/virtualization/configuration/data/ConfigurationDataDozModServerToDozModClient.java
+++ b/src/main/java/org/openslx/virtualization/configuration/data/ConfigurationDataDozModServerToDozModClient.java
@@ -6,7 +6,8 @@ import org.openslx.bwlp.thrift.iface.OperatingSystem;
/**
* Data container to collect and store input arguments for a
- * {@link ConfigurationLogicDozModServerToDozModClient} transformation.
+ * {@link org.openslx.virtualization.configuration.logic.ConfigurationLogicDozModServerToDozModClient}
+ * transformation.
*
* @author Manuel Bentele
* @version 1.0
@@ -40,7 +41,8 @@ public class ConfigurationDataDozModServerToDozModClient
/**
* Creates a new data container to collect and store input arguments for a
- * {@link ConfigurationLogicDozModServerToDozModClient} transformation.
+ * {@link org.openslx.virtualization.configuration.logic.ConfigurationLogicDozModServerToDozModClient}
+ * transformation.
*
* @param displayName display name for a transformation of a virtualization configuration.
* @param diskImage disk image file for a transformation of a virtualization configuration.
diff --git a/src/main/java/org/openslx/virtualization/configuration/data/ConfigurationDataDozModServerToStatelessClient.java b/src/main/java/org/openslx/virtualization/configuration/data/ConfigurationDataDozModServerToStatelessClient.java
index e92df92..65cc7ce 100644
--- a/src/main/java/org/openslx/virtualization/configuration/data/ConfigurationDataDozModServerToStatelessClient.java
+++ b/src/main/java/org/openslx/virtualization/configuration/data/ConfigurationDataDozModServerToStatelessClient.java
@@ -2,7 +2,8 @@ package org.openslx.virtualization.configuration.data;
/**
* Data container to collect and store input arguments for a
- * {@link ConfigurationLogicDozModServerToStatelessClient} transformation.
+ * {@link org.openslx.virtualization.configuration.logic.ConfigurationLogicDozModServerToStatelessClient}
+ * transformation.
*
* @author Manuel Bentele
* @version 1.0
@@ -27,7 +28,8 @@ public class ConfigurationDataDozModServerToStatelessClient
/**
* Creates a new data container to collect and store input arguments for a
- * {@link ConfigurationLogicDozModServerToStatelessClient} transformation.
+ * {@link org.openslx.virtualization.configuration.logic.ConfigurationLogicDozModServerToStatelessClient}
+ * transformation.
*
* @param displayName display name for a transformation of a virtualization configuration.
* @param osId operating system identifier for a transformation of a virtualization
diff --git a/src/main/java/org/openslx/virtualization/configuration/logic/ConfigurationLogicDozModClientToDozModServer.java b/src/main/java/org/openslx/virtualization/configuration/logic/ConfigurationLogicDozModClientToDozModServer.java
index d64f42a..f375693 100644
--- a/src/main/java/org/openslx/virtualization/configuration/logic/ConfigurationLogicDozModClientToDozModServer.java
+++ b/src/main/java/org/openslx/virtualization/configuration/logic/ConfigurationLogicDozModClientToDozModServer.java
@@ -14,7 +14,7 @@ import org.openslx.virtualization.configuration.transformation.TransformationExc
*
*
* +------------------------------+ DozModClientToDozModServer +------------------------------+
- * | virtualization configuration | ----------------------------> | virtualization configuration |
+ * | virtualization configuration | ----------------------------▶ | virtualization configuration |
* +---------------+--------------+ transformation logic +---------------+--------------+
* | dozmod-client | | dozmod-server |
* +---------------+ +---------------+
diff --git a/src/main/java/org/openslx/virtualization/configuration/logic/ConfigurationLogicDozModServerToDozModClient.java b/src/main/java/org/openslx/virtualization/configuration/logic/ConfigurationLogicDozModServerToDozModClient.java
index 05b3d4a..06c8ad1 100644
--- a/src/main/java/org/openslx/virtualization/configuration/logic/ConfigurationLogicDozModServerToDozModClient.java
+++ b/src/main/java/org/openslx/virtualization/configuration/logic/ConfigurationLogicDozModServerToDozModClient.java
@@ -18,7 +18,7 @@ import org.openslx.virtualization.configuration.transformation.TransformationExc
*
*
* +------------------------------+ DozModServerToDozModClient +------------------------------+
- * | virtualization configuration | ----------------------------> | virtualization configuration |
+ * | virtualization configuration | ----------------------------▶ | virtualization configuration |
* +---------------+--------------+ transformation logic +---------------+--------------+
* | dozmod-server | | dozmod-client |
* +---------------+ +---------------+
diff --git a/src/main/java/org/openslx/virtualization/configuration/logic/ConfigurationLogicDozModServerToStatelessClient.java b/src/main/java/org/openslx/virtualization/configuration/logic/ConfigurationLogicDozModServerToStatelessClient.java
index 580b0fc..30d690a 100644
--- a/src/main/java/org/openslx/virtualization/configuration/logic/ConfigurationLogicDozModServerToStatelessClient.java
+++ b/src/main/java/org/openslx/virtualization/configuration/logic/ConfigurationLogicDozModServerToStatelessClient.java
@@ -16,7 +16,7 @@ import org.openslx.virtualization.configuration.transformation.TransformationExc
*
*
* +------------------------------+ DozModServerToStatelessClient +------------------------------+
- * | virtualization configuration | -------------------------------> | virtualization configuration |
+ * | virtualization configuration | -------------------------------▶ | virtualization configuration |
* +---------------+--------------+ transformation logic +------------------+-----------+
* | dozmod-server | | stateless client |
* +---------------+ +------------------+
diff --git a/src/main/java/org/openslx/virtualization/configuration/transformation/TransformationSpecific.java b/src/main/java/org/openslx/virtualization/configuration/transformation/TransformationSpecific.java
index 5b13f45..7038abf 100644
--- a/src/main/java/org/openslx/virtualization/configuration/transformation/TransformationSpecific.java
+++ b/src/main/java/org/openslx/virtualization/configuration/transformation/TransformationSpecific.java
@@ -23,6 +23,7 @@ public abstract class TransformationSpecific extends Transformationtrue if image type is supported by the virtualizer; otherwise
* false
.
*/
diff --git a/src/main/java/org/openslx/vm/disk/DiskImageQcow2.java b/src/main/java/org/openslx/vm/disk/DiskImageQcow2.java
index 04e61ea..657c144 100644
--- a/src/main/java/org/openslx/vm/disk/DiskImageQcow2.java
+++ b/src/main/java/org/openslx/vm/disk/DiskImageQcow2.java
@@ -51,7 +51,7 @@ public class DiskImageQcow2 extends DiskImage
/**
* Creates a new QCOW2 disk image from an existing QCOW2 image file.
*
- * @param diskImage file to a QCOW2 disk storing the image content.
+ * @param disk file to a QCOW2 disk storing the image content.
*
* @throws FileNotFoundException cannot find specified QCOW2 disk image file.
* @throws IOException cannot access the content of the QCOW2 disk image file.
@@ -64,7 +64,7 @@ public class DiskImageQcow2 extends DiskImage
/**
* Creates a new QCOW2 disk image from an existing QCOW2 image file.
*
- * @param diskImage file to a QCOW2 disk storing the image content.
+ * @param disk file to a QCOW2 disk storing the image content.
*/
public DiskImageQcow2( RandomAccessFile disk )
{
diff --git a/src/main/java/org/openslx/vm/disk/DiskImageUtils.java b/src/main/java/org/openslx/vm/disk/DiskImageUtils.java
index cc29721..ccb053f 100644
--- a/src/main/java/org/openslx/vm/disk/DiskImageUtils.java
+++ b/src/main/java/org/openslx/vm/disk/DiskImageUtils.java
@@ -114,12 +114,12 @@ public class DiskImageUtils
}
/**
- * Reads two bytes ({@link Short}) at a given offset
from the specified disk image
- * file.
+ * Reads a variable number of bytes (numBytes
) at a given offset
from the specified disk image file.
*
* @param diskImage file to a disk storing the image content.
- * @param offset offset in bytes for reading the two bytes.
- * @return value of the two bytes from the disk image file as {@link Short}.
+ * @param offset offset in bytes for reading numBytes
bytes.
+ * @param numBytes number of bytes to read at offset
.
+ * @return read bytes from the disk image file as {@link String}.
*
* @throws DiskImageException unable to read two bytes from the disk image file.
*/
diff --git a/src/main/java/org/openslx/vm/disk/DiskImageVmdk.java b/src/main/java/org/openslx/vm/disk/DiskImageVmdk.java
index 7f59bc3..b2f45a1 100644
--- a/src/main/java/org/openslx/vm/disk/DiskImageVmdk.java
+++ b/src/main/java/org/openslx/vm/disk/DiskImageVmdk.java
@@ -183,7 +183,8 @@ public class DiskImageVmdk extends DiskImage
*
* @return hardware version from the VMDK's embedded descriptor file.
*
- * @throws DiskImageException
+ * @throws DiskImageException unable to obtain the VMDK's hardware version of the disk image
+ * format.
*/
public Version getHwVersion() throws DiskImageException
{
--
cgit v1.2.3-55-g7522