> For the complete documentation index, see [llms.txt](https://cgps.gitbook.io/data-flo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cgps.gitbook.io/data-flo/reference-guide/import-file-from-smb-share.md).

# import-file-from-smb-share

## Description

<mark style="color:purple;">`import-file-from-smb-share`</mark> *adaptor imports a file from a shared network drive using standard SMB/CIFS protocol.*

## Inputs

**`share address`**\
Type: `text`\
Required: Yes\
The name of the service to which you want to connect. Takes the form of `\\server\service`, `//server/service`, or `smb://server/service` where `server` is the host name or IP address of the SMB/CIFS server, and `service` is the name of the service offered by the server.

**`port`**\
Type: `number`\
Required: No\
The port of the SMB server. If unspecified, defaults to `445`.

**`domain`**\
Type: `text`\
Required: No\
The domain on which the user is registered. e.g. `WORKGROUP`.

**`username`**\
Type: `text`\
Required: No\
The username required to access the specified service on the server. If unspecified, defaults to `guest`.

**`password`**\
Type: `text`\
Required: No\
The password required to access the specified service on the server.

**`file path`**\
Type: `text`\
Required: Yes\
The relative path (e.g. `folder\file.txt`) or the absolute path (e.g. `\\server\service\folder\file.txt`) of the file to be imported.

## Outputs

**`file`**\
Type: `file`\
The imported file.

## Examples

### Example 1: Default behaviour.

#### Inputs:

`share address:` \\\localhost\share

`port:` 8445

`domain:` *null (empty)*

`username:` joe

`password:` samba

`file path:` folder\hello-world.txt

#### Outputs:

`file:` hello-world.txt

-> Imported the file hello-world.txt from a shared network drive using standard SMB/CIFS protocol.