---
name: "dpm-register"
section: "1"
platform: "linux"
package: "dpm"
version: "1.10.0-2+b3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/dpm-register"
---

# dpm-register(1)

register external files in DPNS

## NAME

dpm-register - register external files in DPNS

## SYNOPSIS

**dpm-register** **--filesize** *filesize* \[ **--user** *owner\_user* \] \[ **--group** *owner\_group* \] \[ **--mode** *filemode* \]  **--pfn** *pfn* **--server** *hostname* \[ **--st** *status* \] \[ **--help** \] *filename*

## DESCRIPTION

**dpm-register** registers a given filename with the specified permissions into DPNS:\
    \- create the file metadata entry in DPNS (dpns\_creat)\
    \- set the ownership (dpns\_chown) to *owner\_user* : *owner\_group* (by default the requester's DN and group)\
    \- set the filemode (dpns\_chmod) to *filemode*\
    \- set the size of the file (dpns\_setfsize) to *filesize*\
    \- add the replica entry (dpns\_addreplicax) setting\
      \* sfn =  *pfn*\
      \* status to *status* ('O' for Online, 'N' for Nearline)\
      \* f\_type = 'P' (Permanent)\
      \* r\_type = 'P' (Primary)

## EXAMPLE

```
	dpm-register --filesize 525424 --server `hostname --fqdn` \
		--group biomed --pfn dicom:///1/2/3 \
		/dpm/cern.ch/home/biomed/mdm/1/2/3
```

## EXIT STATUS

This program returns 0 if the operation was successful or \>0 if the operation failed.

## SEE ALSO

**[dpns\_creat(3)](/dpns_creat/3.md)**, **[dpns\_chown(3)](/dpns_chown/3.md)**, **[dpns\_chmod(3)](/dpns_chmod/3.md)**, **[dpns\_setfsize(3)](/dpns_setfsize/3.md)**, **[dpns\_addreplicax(3)](/dpns_addreplicax/3.md)**